Get started
Install horus-os, add a provider key, and run your first agent. A few commands and you are live.
Install
horus-os ships as a Python package. The [all] extra pulls in both provider SDKs and the bundled dashboard. Python 3.11 or newer is required.
$ pip install 'horus-os[all]'Add your API keys
Run the interactive setup. It walks you through pasting your keys, validates each one live against the provider before saving, and writes them to a local config. horus-os needs at least one provider key, and your keys stay on your machine.
$ horus-os init --interactiveNeed a key? Create one from your provider console:
Prefer environment variables? Export at least one of these instead of running init:
$ export ANTHROPIC_API_KEY=...$ export GEMINI_API_KEY=...Use it
Hand your team a goal from the command line, or start the local server and drive everything from the dashboard.
$ horus-os run "Summarize today's notes."$ horus-os servehorus-os serve opens the dashboard at http://127.0.0.1:8765, the same interface you see in the demo, now running your own agents.
You are all set
That is the whole setup. Want to see what it looks like first? Explore the live demo with sample data, no install required.