First run

cd /your/project
openheron init                      # generate the configuration in the current directory
export DEEPSEEK_API_KEY=sk-...     # secrets are read from the environment only
openheron

Open http://localhost:8080.

openheron init writes six files:

your/project/
└── .openheron/
    ├── agents/
    │   ├── main.md          # entry agent: understand, split, delegate, verify
    │   └── task.md          # executor agent: does the actual work
    ├── llm/
    │   └── deepseek.yaml    # model profile
    ├── policy/
    │   ├── permissions.yaml # approval policy
    │   └── limits.yaml      # caps on quantities
    └── server/
        └── config.yaml      # process parameters (not hot-reloaded)

★ Existing files are not overwritten (unless you pass --force), so running it in an already-configured project is safe.

Other init options: