open-index/open-npm huggingface dataset:
npm package: @kemu-io/kemu-cli
Description: A CLI tool to execute Kemu recipes.
Latest version: 0.1.8

# Kemu CLI

A CLI tool to execute Kemu recipes.

## Installation

Install the package via npm:

```bash
npm install -g @kemu-io/kemu-cli
```

Or install locally:

```bash
npm install @kemu-io/kemu-cli
```

After installation, the `kemu` binary will be available in your PATH (for global installs) or in `node_modules/.bin/` (for local installs).

## Usage

### Running a Recipe

To execute a Kemu recipe:

```bash
kemu run ./recipe.kemu
```

Or if installed locally:

```bash
npx kemu run ./recipe.kemu
```

### Command Options

- `-e, --env <path>`: Path to `.env` file containing environment variables
- `--env-file <path>`: Path to `.env` file (alias for `--env`)

### Example

```bash
kemu run ./my-recipe.kemu --env .env
```

## How It Works

When you run a recipe, the CLI tool:

1. Loads and validates the `.kemu` recipe file
2. Detects required services from the recipe
3. Downloads and installs missing services from the Kemu Marketplace
4. Sets up the execution environment
5. Executes the recipe with your environment variables

Services are automatically cached locally, so subsequent runs are faster.

## License

Proprietary software copyright (c) Kemu Platform. All rights reserved.