Odysseus is the meta-repo and unified architecture hub for the HomericIntelligence distributed agent mesh. It contains documentation, Architecture Decision Records (ADRs), shared configurations, runbooks, and all other HomericIntelligence repositories as git submodules.
Odysseus serves as the single source of truth for:
- System architecture and design decisions
- Cross-repo operational runbooks
- Shared infrastructure configurations (Nomad, NATS)
- Submodule references to every HomericIntelligence repo
git clone --recurse-submodules https://github.com/HomericIntelligence/Odysseus.git
cd Odysseus
just bootstrapIf you already cloned without submodules:
git submodule update --init --recursiveComplete documentation is available in the docs/ directory:
- Documentation Index — Table of contents for all architecture, decisions, and operational guides
- System Architecture — Complete overview of all components and interactions
- Architecture Decision Records — All significant architectural decisions with rationale
- Operational Runbooks — Step-by-step guides for common operational tasks
- NATS Subject Schema — Event bus subject patterns and streams
- Agent Safety Boundaries — Permitted tools, scope, off-limits files, and escalation paths for AI agents operating in this repo
Odysseus/
├── docs/
│ ├── README.md # Documentation index and table of contents
│ ├── architecture.md # Full system architecture overview
│ ├── adr/ # Architecture Decision Records
│ └── runbooks/ # Operational runbooks
├── configs/
│ ├── nomad/ # Nomad client/server HCL configs
│ └── nats/ # NATS server and leaf node configs
├── infrastructure/ # Submodules: AchaeanFleet, ProjectArgus, ProjectHermes
├── provisioning/ # Submodules: ProjectTelemachy, ProjectKeystone, Myrmidons
├── ci-cd/ # Submodules: ProjectProteus
├── research/ # Submodules: ProjectOdyssey, ProjectScylla
├── shared/ # Submodules: ProjectMnemosyne, ProjectHephaestus
├── justfile
└── pixi.toml
| Command | Description |
|---|---|
just bootstrap |
Initialize and update all submodules |
just status |
Show status across all submodules |
just apply-all |
Apply Myrmidons declarative state via the Agamemnon API |
just update-submodules |
Pull latest commits for all submodules |
just hermes-start |
Start ProjectHermes event bridge |
just argus-start |
Start ProjectArgus observability stack |
just telemachy-run WORKFLOW |
Run a named workflow via ProjectTelemachy |
- ai-maestro has been removed per ADR-006. All task coordination uses ProjectAgamemnon (
control/ProjectAgamemnon, REST API at$AGAMEMNON_URL). - See docs/architecture.md for the current system architecture.
- See docs/adr/ for Architecture Decision Records.