Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.charmos.io/llms.txt

Use this file to discover all available pages before exploring further.

Use this guide to troubleshoot common local and cloud execution issues.

​
Start with Validation

charm validate .
Fix manifest and entry point issues before debugging runtime behavior.

​
Run with Debug Logs

charm run . --input "Hello" --debug

​
Common Issues

​
Import or Entry Point Error

Check runtime.adapter.entry_point and make sure the module/object exists.

​
Missing Environment Variable

Declare required keys in charm.yaml and provide local values in .env.

​
Timeout

Reduce long-running work or move persistent behavior to daemon lifecycle.

​
Out of Memory

Avoid loading large local models or large datasets into memory.

​
Works Locally but Fails in Cloud

Run Docker sandbox mode: 
charm run . --input "Hello" --docker
Then check cloud logs: 
charm logs --path .

​
Getting Help

If you are blocked, open an issue or ask in Discord with validation output, logs, and reproduction steps.