Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
GitHub didn't answer, so this is the saved copy from 2 days ago
Will it work on Linux?
Heads-upIt also needs 2 settings in .env (2 secret).
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/omnilabs-ai/OmniRouter.git cd OmniRouter
Python 3.12
curl -LsSf https://astral.sh/uv/install.sh | sh
Fill in secrets: ANTHROPIC_API_KEY, OPENAI_API_KEY
cp .env.example .env
uv sync
uv run pytest
Python 3.12, managed with uv.
uv sync --all-groups # install the project and dev tools
uv run pre-commit install # ruff, gitleaks and hygiene hooks on every commit
uv run omni --version
uv run omni db upgrade # creates .omni/omni.db and applies migrations
uv run pytest # offline tests, no API keys needed
uv run ruff check . && uv run ruff format --check .
| Variable | Purpose | Default |
|---|---|---|
| DATABASE_URL | SQLAlchemy URL for the metadata store; Postgres via postgresql+psycopg://... | sqlite:///.omni/omni.db |
| OPENAI_API_KEY, ANTHROPIC_API_KEY, … | Provider keys, read by the provider SDKs during replays | unset |
Keys are never stored by this code and never committed; see .env.example.
No reports for Linux yet.
GitManual AI Agent reads the 7 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.