Roadmap
Where horus-os is right now, what has shipped from v0.1 to v0.8, and what comes next.
Current status#
The latest shipped release is v0.8.0 ("Local-first and Autonomous Research"), tagged on 2026-06-03. The runtime is Python 3.11+, the dashboard is a static-exported Next.js app bundled into the wheel, and persistence is a single SQLite file at database schema version 13.
Since the v0.8.0 tag, five product surfaces have landed on main and
sit unreleased in the changelog [Unreleased] section, shipping in the
next tagged cut: a streaming dashboard chat surface, an agent store
with a custom-agent builder, an opt-in Twilio voice adapter, a 10-step
onboarding tour, and a mobile sidebar drawer with a new agent Standup
view.
horus-os is open for outside contributions as of 2026-06-10: pick an
issue labeled good-first-issue or help-wanted, comment to claim
it, and the maintainer assigns it. The single most valuable outside
input remains real-use feedback: run horus-os against a real
workload, then open a GitHub Discussion about what worked and what
did not. For the full collaboration policy, read the
contributing guide and the
security policy.
Planning detail lives in the repository's .planning/ directory and
ROADMAP.md. This page summarizes the public-facing status. For the
exact contents of each release, read the
changelog and the
GitHub Releases page.
Milestone timeline#
Each milestone is a set of phases that ships as one tagged release. A milestone is shipped when it is tagged and published on the Releases page.
| Milestone | Scope | State | Tag | Date |
|---|---|---|---|---|
| v0.1 Foundation | Single-agent runtime, two providers, CLI, dashboard, three-OS install gate | Shipped | v0.1.0 | 2026-05-23 |
| v0.2 Multi-Agent + Streaming | Named agent profiles, delegate_to_agent, provider streaming, adapter plugin contract | Shipped | v0.2.0 | 2026-05-23 |
| v0.3 Adapter Ecosystem | Discord, Slack, Email, and Calendar adapters, lifecycle hooks, dashboard adapters view | Shipped | v0.3.0 | 2026-05-24 |
| v0.4 Observability | Cost, latency, and tool-reliability tracking, observability dashboard tab, opt-in OpenTelemetry exporter, horus-os usage | Shipped | v0.4.0 | 2026-05-26 |
| v0.5 Plugin System | Third-party tools and adapters from a horus-plugin.toml manifest, default-deny capability grants, two-phase installer | Shipped | v0.5.0 | 2026-05-27 |
| v0.6 Contribution Gate | Supply-chain hardening and contributor readiness work. Folded into the contribution gate, never tagged as its own release. | Folded in | (none) | n/a |
| v0.7 Command Center | Bundled Next.js dashboard, Setup-and-Verify integrations surface, Discord control bot, Supabase sync, cron scheduler, opt-in Vercel deploy | Shipped | v0.7.0 | 2026-06-03 |
| v0.8 Local-first + Autonomous Research | Local LLM provider, on-device vector memory, MCP client, web access, vision and PDF, Deep Research, skills, gated shell, all opt-in | Shipped | v0.8.0 | 2026-06-03 |
| v0.9 Autonomy and Control | Event and hook substrate, budgets that pause on breach, risk-tiered approvals, secrets redaction, priority lanes, watches, controlled overnight autonomy, supervision surface | Planned | (none) | (planning) |
v0.6 (Contribution Gate) was never published as its own tag. Its
supply-chain and contributor-readiness work landed without a release,
so v0.7.0 follows v0.5.0 directly in the tag history.
What has shipped#
v0.8 Local-first and Autonomous Research#
The local-first milestone. A bare pip install 'horus-os' still starts
with only an LLM key and activates none of the new features; each
capability lives behind its own optional extra so you install exactly
what you turn on.
- Local LLM provider (extra:
local-llm). Point horus-os at any OpenAI-compatible local server (Ollama, llama.cpp, LM Studio, vLLM, OpenRouter) through abase_urloverride. - On-device vector memory (extra:
local-memory, off by default). Local ONNX text embeddings and a KNN index in a rebuildablevectors.sqlitecache, with zero network egress on memory writes. See the vault. - MCP client (extra:
mcp). Connect to allowlisted Model Context Protocol servers over stdio, SSE, and streamable-http. See the MCP integration. - Web access (extra:
web). A bring-your-ownweb_searchtool and an SSRF-guarded web fetch. See web access. - Vision and PDF analysis (extras:
vision,pdf). Ananalyze_filetool scoped to the data directory'suploads/folder. - Deep Research (flagship). A coordinator workflow that delegates to a Researcher sub-agent and synthesizes a cited Markdown report. See autonomous research.
- Skills system. Reusable, TOML-defined agent behaviors discovered
from the data directory's
skills/folder. - Gated shell execution. A
shell_exectool behind a double lock (HORUS_OS_SHELL_ENABLED=trueplus an explicitallowed_toolsgrant), audited to SQLite.
Schema moved from 12 to 13 (additive, idempotent). The local-memory
extra is intentionally excluded from [all].
v0.7 Command Center#
Turned horus-os into a polished command center on first run.
- Bundled Next.js dashboard with a design system and a locked sidebar. See the dashboard guide.
- Setup-and-Verify integrations surface with per-integration walkthroughs and a key-write and verification flow.
- Opt-in Discord control bot, opt-in Supabase sync loop, a cron scheduler with an always-on service, and an opt-in Vercel deploy path. See scheduling agents and running as a service.
- Four new opt-in extras:
discord,supabase,vercel,github, all excluded from[all]. Schema advanced to v12.
v0.5 Plugin System#
Third-party tools and adapters loadable from a horus-plugin.toml
manifest, with default-deny capability grants, a two-phase installer,
a /plugins dashboard tab, and per-plugin observability. See
plugins and
plugin security. Schema v5 to v6.
v0.4 Observability#
Cost, latency, and tool-reliability tracking per agent run, an
/observability dashboard tab, the horus-os usage CLI, and an opt-in
OpenTelemetry exporter behind the otel extra. See
observability and
OpenTelemetry.
v0.3 Adapter Ecosystem#
Adapter lifecycle hooks plus four first-party adapters: Discord, Slack,
Email (IMAP and SMTP), and Calendar (Google), with an AdapterRegistry
and a dashboard adapters tab. See the
integrations overview.
v0.2 Multi-Agent + Streaming#
Named agent profiles in SQLite with parent and child trace links, the
delegate_to_agent tool, streaming responses via provider streaming
APIs, and the adapter plugin contract. See the
agent team.
v0.1 Foundation#
The first public alpha: a single-agent runtime, two providers (Anthropic and Gemini), one tool, persistent SQLite, and a CLI plus local dashboard, gated behind a three-OS install check.
What comes next#
The next planned milestone is v0.9, Autonomy and Control: the rails that make autonomy safe to turn on. v0.8 shipped raw power (autonomous research, gated shell, metered but unbounded spend); v0.9 adds monetary budgets that pause on breach, risk-tiered approvals, secrets redaction, an event and hook substrate, priority lanes, watch rules, and controlled overnight autonomy behind every gate. It is the first of a six-milestone program (v0.9 through v0.14) covering memory and learning, work legibility, workspace and models, interop and distribution, and interaction modality.
This is a program-level map, not a committed milestone plan; scope is
finalized through the normal planning flow before any phase work
begins. The detail lives in the repository's .planning/ directory
(PROGRAM-v0.9-v0.14.md).
The project is open for outside contributions; the contributing guide covers the claim flow. The highest-value contribution is still real-use feedback in GitHub Discussions, which shapes the roadmap.
Anti-goals#
These are out of scope and stay out of scope, even after contributions open:
- A hosted SaaS offering of horus-os.
- Coupling to any single cloud provider beyond your chosen LLM API.
- Features that require a paid third-party account beyond optional LLM API keys.
- Multi-tenant deployment patterns.