Local Execution - Charm Docs

Run agents locally while you iterate on code and manifest changes.

Simple Input

charm run . --input "Hello"

charm run . --json '{"message": "Hello", "tone": "friendly"}'

Use field names that match interface.input.properties in charm.yaml.

charm run . --input-file tests.json

Example:

[
  {
    "name": "Greeting",
    "input": {
      "message": "Hello"
    }
  }
]

For local development, put non-production values in .env:

OPENAI_API_KEY=...
TAVILY_API_KEY=...

Never commit .env files containing secrets.

charm run . --input "Hello" --docker

Use Docker mode before publishing when dependencies or runtime behavior may differ from your host machine.