OmniAgent

Multi-layer agent platform: UI (web / CLI / SDK) → ACP protocol → environment (local, Docker, sandbox) → LangGraph core (planning, tools, memory).

Layout

• configs/ — YAML configuration (agent, ACP, per-environment overrides).
• omni_agent/ — Python package: ui, acp, environment, core.
• tests/ — unit, integration, and e2e tests.
• docs/ — architecture and protocol notes.
• docker/ — container build and compose.
• scripts/ — helper shell scripts for local runs.

Quick start

# Install (recommended: uv)
uv sync

# CLI entry (after install)
omni-agent --help

Copy .env.example to .env and set API keys or local model endpoints as needed.

Development

uv run pytest
uv run ruff check omni_agent tests

Shell helpers under scripts/ are written for Bash (Git Bash / WSL / macOS / Linux). On Windows without Bash, run the same commands from a terminal manually (for example uv run uvicorn omni_agent.ui.web.app:app).