CLI society
Install: uv workspace, package society-cli. From the repo root, with the project venv.
URLs via env (Development defaults):
| Variable | Default |
|---|---|
SOCIETY_FLEET_MANAGER_URL | http://localhost:8088 |
SOCIETY_GOVERNANCE_URL | http://localhost:8090 |
SOCIETY_TELEMETRY_URL | http://localhost:8091 |
SOCIETY_EVALUATOR_URL | http://localhost:8092 |
SOCIETY_CHAT_URL | http://localhost:8094 |
Identity toward telemetry: M2M app sis-cli if configured; otherwise SOCIETY_INTERNAL_TOKEN. With auth off, telemetry ignores headers. dev:write goes through telemetry_headers_break_glass().
Live groups
| Group | For |
|---|---|
builder | YAML spec → deploy / provision-profiles / apply |
fleet spawn | create a profile from template (renders SOUL). The rest of fleet is a historical name |
profile | list / suspend / destroy |
host | federation hosts |
chat | /v1/models, goal-candidates |
kanban | board via fleet-manager |
rag | ingest / list / drop (--host isolates the collection) |
skill | marketplace |
artifact | object store |
governance approval | inbox |
telemetry | snapshot / status |
evaluator / fitness / gym | quality and F0+ rungs |
facts | public library |
dev | local reset / diagnostics |
vision / audio / ros2 | contracts (ROS2 = future) |
society chat models
society builder deploy-approved --spec <yaml> --yes
society rag ingest --profile researcher --host <h> --path ./corpus --confirm INGEST
In the container orchestrator stack, prefix the RAG command with containers exec society-executor and use a
path mounted inside that container. society --help is the list that does not lie. This
page was harvested against tools/society-cli/src/society_cli/main.py on 2026-08-27.