▚ harmonia — agents as code

Declare an agent team in a file.
Judge it before it runs. Deploy it like software.

A team is a file in your repo — diffable, reviewable, pinned by the deploy. The service judges the whole plan before anything runs. N agents writing one shared field lose nothing, and every step settles onto a sealed receipt you can verify.

A team in a file, not code in a box

Agents, shared state, ordering, landings — declared in TOML your reviewers can read in a pull request.

The judgment before the run

deploy --plan answers with the full refusal catalog and the execution picture — models, orderings, landings — before anything executes.

Concurrency and memory, on the record

Concurrent writers compose; contention is counted, not feared. Teams keep memory between runs on a hash-linked chain that follows the team's name.

The five minutes

1
Install
pip install harmonia-sdk

Zero dependencies. Design partners: install the wheel you were handed — same name, same verbs.

2
Point at the service
export HARMONIA_SERVICE=https://harmonia.build
export HARMONIA_KEY=hk_…

The key names your workspace on tenant-aware services; worlds never touch. An open development service needs no key.

3
Declare a team — save as team.toml

  
two researchers land on ONE field at the same time; the editor folds what landed

Prefer clicking? The console builds this file for you: declare a team in the browser — same file, same judge.

4
Judge, then deploy
harmonia validate team.toml
harmonia deploy team.toml --plan
harmonia deploy team.toml

Validate is the offline gate. --plan is the service's judgment — refusals in plain words, or the picture of exactly what would run. Deploy commits that picture and answers with the deployment id.

5
Run it
harmonia run dep-1 -i "topic=our own launch"

The run streams to settlement in your terminal; the console shows the same story — what it was asked, what it produced, where the time went, the receipts and their seals, contention on the shared field. Nothing is lost; everything is on the record.