Skip to main content
This guide covers the normal workflow for building Charm agents.

Developer Workflow

Initialize -> Configure -> Develop -> Validate -> Run -> Publish -> Observe

1. Initialize

Start from a template:
charm init my-agent --template python
See Build Your First Agent.

2. Configure

Edit charm.yaml to define identity, inputs, runtime, pricing, auth, and policies. See Configuration.

3. Develop

Write agent logic in the entry point declared in the manifest. See Local Execution.

4. Validate

charm validate .
See Validation.

5. Run

charm run . --input "Hello"
Use Docker mode to simulate the cloud runtime.

6. Publish

charm push .
See Publishing.

7. Observe

Use Store, Studio, and CLI logs to inspect production behavior.

Extending Charm

For adapters, runtimes, telemetry, memory, UI, templates, and renderers, start with Extensibility Overview.