Configurable multi-agent orchestration system. Amir reads a YAML team configuration, wires agents, roles, and workflow gates, and exposes a service layer for coordinating multi-agent workflows.
Status: Alpha — Core architecture is established. APIs and configuration schemas may evolve.
- Python 3.13 or higher
Clone and install locally:
git clone https://github.com/salimnamvar/amir.git
cd amir
pip install -e .Run the CLI:
amirClone the repository and install with dev dependencies:
git clone https://github.com/salimnamvar/amir.git
cd amir
pip install -e ".[dev]"Run the linter:
ruff check src/ tests/Run the formatter:
ruff format src/ tests/Run the type checker:
pyrightRun the tests:
pytest- Domain-driven modeling with immutable entities and value objects
- Protocol-based repository contracts
- YAML-driven configuration validated at startup with Pydantic
- Structured logging with async queue support
- Separation between contract, repository, service, and infrastructure layers
Contributions are accepted. Open an issue or submit a pull request at the source repository.