horus-os

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.

Note

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.

MilestoneScopeStateTagDate
v0.1 FoundationSingle-agent runtime, two providers, CLI, dashboard, three-OS install gateShippedv0.1.02026-05-23
v0.2 Multi-Agent + StreamingNamed agent profiles, delegate_to_agent, provider streaming, adapter plugin contractShippedv0.2.02026-05-23
v0.3 Adapter EcosystemDiscord, Slack, Email, and Calendar adapters, lifecycle hooks, dashboard adapters viewShippedv0.3.02026-05-24
v0.4 ObservabilityCost, latency, and tool-reliability tracking, observability dashboard tab, opt-in OpenTelemetry exporter, horus-os usageShippedv0.4.02026-05-26
v0.5 Plugin SystemThird-party tools and adapters from a horus-plugin.toml manifest, default-deny capability grants, two-phase installerShippedv0.5.02026-05-27
v0.6 Contribution GateSupply-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 CenterBundled Next.js dashboard, Setup-and-Verify integrations surface, Discord control bot, Supabase sync, cron scheduler, opt-in Vercel deployShippedv0.7.02026-06-03
v0.8 Local-first + Autonomous ResearchLocal LLM provider, on-device vector memory, MCP client, web access, vision and PDF, Deep Research, skills, gated shell, all opt-inShippedv0.8.02026-06-03
v0.9 Autonomy and ControlEvent and hook substrate, budgets that pause on breach, risk-tiered approvals, secrets redaction, priority lanes, watches, controlled overnight autonomy, supervision surfacePlanned(none)(planning)
Note

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 a base_url override.
  • On-device vector memory (extra: local-memory, off by default). Local ONNX text embeddings and a KNN index in a rebuildable vectors.sqlite cache, 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-own web_search tool and an SSRF-guarded web fetch. See web access.
  • Vision and PDF analysis (extras: vision, pdf). An analyze_file tool scoped to the data directory's uploads/ 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_exec tool behind a double lock (HORUS_OS_SHELL_ENABLED=true plus an explicit allowed_tools grant), 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.

See also#