Hacker News

Show HN: HART OS - an open-source AI OS built so frontier AI needs no datacenter

Comments

Hevolve Hive Agentic Runtime - The AI-native operating system for every device, from your computer to embodied AI. Local-first, federated, OpenAI-compatible.

The most capable AI now lives inside a handful of organisations that can put enough compute in one building. That concentration is an architectural choice rather than a law of physics, and it decides what the models will refuse, what they cost, and who gets to read what you type.

The Architectural Choice

To be precise, because this is the obvious thing to attack: you cannot train a frontier model without a datacenter, and we are not claiming you can. What we are claiming is that the intelligence people actually use does not have to be delivered from one.

HART OS runs models on the device, and when a node cannot handle something it recruits a peer directly, with no broker and no company in the middle. We do not shard a model across the network either. Layer-level parallelism over consumer links is a bad idea and we do not attempt it. A peer serves a whole request instead, so a machine with a bigger model answers what a smaller one could not, which tolerates latency in a way tensor parallelism does not.

The things we have not solved are written down in OPEN_PROBLEMS.md, each naming the file that implements today's inadequate answer.

Components

  • HART = the bare engine (run from this repo, listens on :6777). There is no published PyPI package yet, so install it from source as shown below.
  • HART OS = the full AI-native OS. It boots on a laptop, server, or edge node, runs on phones, and reaches into embodied AI, and it ships the agentic Liquid Shell, Model Bus, model catalog, channel pairing, agent dashboard, and hive view.
  • Nunba = the consumer companion app, one signed client across Windows / macOS / Linux.

AI-Native Design

AI-native means the OS adapts to the machine, not the other way around. On each device it probes what the hardware can actually do, serves LLM, vision, and speech to every app over the Model Bus (socket, D-Bus, or HTTP), and lets the on-device model compose the interface and learn each task once so it can replay it later.

The runtime that drives a desktop is the same one that drives a robot, so a robot's AI access is just another Model Bus call. It is one Python codebase that runs in three shapes (flat laptop, regional LAN, or central cloud mesh), speaks the OpenAI protocol on :6777/v1/chat/completions, and federates with peers over PeerLink (direct peer-to-peer WebSocket, no broker).

A boot-time guardrail hash, re-checked every 300 seconds, plus Ed25519 release signing, keep humans in control.

Self-Improvement

You would notice it last, the way you notice anything alive: it improves on its own. Each node learns from what it does and gets quietly better, locally, on your own hardware, with nothing leaving the device.

Calling an operating system alive should make you reach for the off switch, so that came first: the self-improvement is a toggle, every node is killable on its own, and it runs only as long as you let it.

README Structure

This README is written to be read by people and by agents alike. Every capability below names the file it lives in, so whether you are a developer or an AI agent exploring the repo, you can go from a feature straight to its source.

Status: public alpha. The runtime, the Model Bus and the channel adapters are in daily use; APIs still move. Issues and PRs are genuinely wanted - see Contributing. If you would rather argue than patch, start at Open problems.

Nine things we have not solved, each with the code that implements today's inadequate answer and what would count as progress: what convergence can mean with no global view, whether a system that rewrites itself can still be verified, and why a turn escalates itself to a better model automatically but can never decide on its own that a problem deserves an hour and three machines. Disagreeing with a framing there is worth more to us than a patch.

How It Compares to Other Software

Most software described as AI-powered ships an assistant: a separate app, usually talking to somebody else's server, that can drive a few functions. Remove the assistant and everything underneath works exactly as before. HART OS inverts that. Inference becomes a service the system provides, the way it provides a filesystem or a network stack. An application does not bundle a model or hold an API key - it asks the OS, and the OS decides which model answers, running locally where it can. Ten apps on one machine do not each load their own copy or each pay their own bill.

That has a practical consequence worth stating plainly: every device becomes the same target. The runtime driving a laptop is the runtime driving a robot, so a robot's AI access is just another Model Bus call, and code written against :6777/v1/chat/completions runs unchanged on both.

If you are here to contribute, the parts that most need outside eyes are the auto-evolve loop (autoresearch_loop.py), the guardrails that gate every self-improvement (hive_guardrails.py), and the 31 channel adapters - the most self-contained place to start. See CONTRIBUTING.md.

Installation

Honest about the clock: the server is up seconds after the install finishes, but the install itself is not quick. requirements.txt pins 235 packages and pulls torch, torchvision, transformers, onnxruntime and scipy, so budget a few minutes and a few GB on a first run. This section used to be headed "60-second start", which was not true of anything except the last line.

Use Python 3.10 or 3.11, and not a newer one. The python3.10 in the first command is load-bearing rather than decorative. faiss-cpu==1.7.4 publishes wheels for cp37 through cp311 only, so on 3.12 or later the install stops with "No matching distribution found for faiss-cpu==1.7.4", which reads like a broken repository rather than a version mismatch. If your system python is newer, install 3.10 alongside it and point the venv at that.

git clone https://github.com/hertz-ai/HARTOS.git && cd HARTOS
python3.10 -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate.bat
pip install -r requirements.txt
echo "OPENAI_API_KEY=sk-..." > .env  # or GROQ_API_KEY, or none for local llama.cpp
python hart_intelligence_entry.py  # listens on :6777

OpenAI-Compatible Endpoint

curl -X POST http://localhost:6777/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "hevolve", "messages": [{"role": "user", "content": "Hello"}]}'

Live demo ยท Full quickstart ยท Nunba desktop

Feature HART OS OpenAI Agents LangChain AutoGen
Self-improves at runtime (auto-evolve loop + RSI-2 gate) yes no no partial
Continuous baselining vs prior snapshots yes (agent_baseline_service.py) no no no
Built-in benchmark adapters 7 (registry-driven) n/a n/a n/a
Federates across peer nodes yes (PeerLink + hash-verified) no no no
Local-first multimodal yes (llama.cpp + Whisper + 6 TTS + VLM) no partial partial
Channel adapters out of the box 31 1 (webhook) custom custom
One codebase, multiple topologies flat / regional / central hosted only library library
OpenAI-compatible endpoint yes yes bring your own bring your own
Recipe replay (cached LLM steps) yes (90% faster) no no no
Native source protection (HevolveArmor) yes n/a n/a n/a

Capabilities Tables

Agent System

What it does Where
CREATE / REUSE recipe pattern - Run a task once via LLM, save the trace, replay 90% faster with no LLM calls on cached steps create_recipe.py, reuse_recipe.py
GoalManager - Unified goal lifecycle, guardrail-gated state machine, escalation hooks integrations/agent_engine/goal_manager.py
AgentDaemon - Autonomous tick loop, circuit breaker, frozen-thread detection integrations/agent_engine/agent_daemon.py
SpeculativeDispatcher - Fast draft model answers first, expert agent takes over if confidence drops speculative_dispatcher.py
ParallelDispatch - ThreadPoolExecutor fan-out across SmartLedger tasks parallel_dispatch.py
SelfHealingDispatcher - Catches transient failures, retries with backoff + alternative providers self_healing_dispatcher.py
96 expert agents - Coding, research, marketing, product, security, ethics, ops, ... auto-dispatched per goal integrations/expert_agents/
Recipe Pattern + Aider - In-process Aider backend (no subprocess) for code edits integrations/coding_agent/aider_native_backend.py

Auto-Evolve & Benchmarking

What it does Where
AutoEvolve loop - Realtime: hypothesis -> 33-rule filter -> hive vote -> parallel sandbox -> RSI-2 gate -> federated broadcast integrations/agent_engine/auto_evolve.py
RSI-2 monotonic gate - New release must beat prior baseline on every benchmark by configurable margin or PR is rejected rsi_trigger.py, pr_review_service.py
Benchmark registry - 7 built-in adapters (3 sourced from HevolveAI: QuantiPhy, Embodied, Qwen). Pluggable via register_adapter() benchmark_registry.py
Per-agent baselines - Per-agent snapshots at agent_data/baselines/ .json, used as the regression floor agent_baseline_service.py
Coding benchmark tracker - SQLite-backed coding benchmarks (coding_benchmarks.db), HumanEval / MBPP / custom suites integrations/coding_agent/benchmark_tracker.py
Hive benchmark prover - Cryptographic proof that a benchmark was run on the claimed model + dataset (resists fake-score federation) hive_benchmark_prover.py
Continual learner gate - Gates access to hive learning by verified compute contribution (Compute Contribution Tokens): no contribution, no learning continual_learner_gate.py
PR review service - Auto-rejects PRs on baseline regression or guardrail mismatch pr_review_service.py
Upgrade orchestrator - 7-stage pipeline: BUILD -> TEST -> AUDIT -> BENCHMARK -> SIGN -> CANARY -> DEPLOY upgrade_orchestrator.py
OTA service - systemd service does daily check + cryptographically-verified upgrade hart-update-service.py

Peer Networking & Hive

What it does Where
PeerLink - Direct P2P WebSocket mesh, trust-aware encryption (same-user devices skip overhead, cross-user E2E), works offline on LAN, across the internet, multi-device core/peer_link/
NAT traversal - UDP hole-punching, STUN-style fallbacks for residential NATs core/peer_link/nat.py
Hivemind handler - Tier-aware routing (flat / regional / central), connection budget per tier (10 / 50 / 200) core/peer_link/hivemind_handler.py
FederatedAggregator - Equal-weighted delta merging (log1p-floor, not hardware tier). Channels: model deltas, resonance, recipes, event counters federated_aggregator.py
Federated gradient protocol - Optional weight-level sync interface (Phase 2, not active); the hive shares derived, signed, privacy-scoped learning, never raw data or model weights federated_gradient_protocol.py
Federation handshake - Peer presents guardrail hash; mismatch = connection refused; re-verified every 300 s integrations/social/federation.py
Gossip + verification - Tier-aware gossip with cert verification, peer-verified task results integrity_service.py, gossip layer
EventBus + WAMP bridge - In-process EventBus auto-publishes to Crossbar WAMP when CBURL env set; remote nodes subscribe to com.hartos.event.* topics core/platform/events.py
Federated equality - Tier multipliers replaced with log1p(interactions) floor=1.0. A Pi node has the same vote weight as a GPU rack at equal participation (federation rule)
Hive contests - Open contests on the network; agents propose, hive votes, winners federate hive_contest.py
Native hive loader - Loads closed-source HevolveAI binary at runtime with master-key signature verification, falls back to stub security/native_hive_loader.py

Community & Experimentation

What it does Where
Thought experiment - Propose an idea, community votes (humans + agents, confidence-weighted), believers pledge compute api_thought_experiments.py, experiment_discovery_service.py
ComputePledge - Spark-budget pledge to a specific experiment, redeemable on idle GPUs across the network compute_borrowing.py, compute_mesh_service.py
Type-aware agents - software / traditional / physical_ai / code_evolution agent types per experiment dispatch.py
Agent Hive View - Real-time swarm visualization, encounter lines (collaboration), inject mid-experiment variables api_hive_contest.py + Nunba UI
Reasoning trace - Per-agent reasoning capture, queryable post-completion ("interview the agent") reasoning_trace.py

AI Providers & Hardware

What it does Where
15 LLM providers - Local llama.cpp, OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, OpenRouter, Together, Fireworks, Cohere, Perplexity, Hugging Face, Ollama, custom OpenAI-compatible integrations/providers/
Universal gateway - One router, cost / latency / capability scoring, AES-256 keys at rest (PBKDF2 KDF) model_registry.py, model_bus_service.py
Speculative decoding - Qwen3-0.8B draft + Qwen3-4B main, ~300 ms TTFT on consumer hardware speculative_dispatcher.py
Faster-Whisper STT - Local STT, multi-lang, GPU-accelerated when available integrations/service_tools/whisper_tool.py
MiniCPM VLM - Vision-language model for camera + screenshot reasoning integrations/vision/minicpm_server.py
6 TTS engines - Indic Parler (22 Indic + EU), Chatterbox Turbo (English expressive), Kokoro (English neural), CosyVoice3 (en/zh), F5 (zero-shot voice clone), Piper (CPU fallback) integrations/channels/media/, tts.py
Auto-VRAM tiering - Detects GPU + free VRAM, picks largest model that fits with headroom; degrades gracefully on 6 GB cards (runtime)

Comments

No comments yet. Start the discussion.