README.md

---
title: Autonomous OS
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: static
pinned: true
thumbnail: https://cdn.autonomous.ai/production/ecm/260701/thinking2.webp
short_description: Open-source OS for physical AI agents
---

<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;600&display=swap" rel="stylesheet">

<style>
body {
    font-family: 'Inter', sans-serif;
    font-weight: 300;
}
p {
    font-family: 'Inter', sans-serif;
    font-weight: 300;
    font-size: 18px;
    line-height: 1.6;
}
</style>

<div style="text-align: left; max-width: 840px; margin: 0 auto;">

<div style="display: flex; justify-content: center; align-items: center; margin-bottom: 8px;">
<img src="https://cdn.autonomous.ai/production/ecm/260724/autonomous_logo-02-white.png" alt="Autonomous" style="height: 124px;">
</div>

<p style="font-size: 22px; font-weight: 400; text-align: center;">Open-source operating system for physical AI agents.</p>

<p>Autonomous OS turns edge hardware into a complete AI agent — one that sees, hears, speaks, moves, senses, remembers, and updates itself over the air. The OS handles <b>everything below the brain</b>: hardware drivers, WiFi provisioning, a web dashboard, OTA updates, MQTT bridge, multi-channel messaging (Telegram, Slack, Discord, WhatsApp), and a 2-second sensing loop that runs vision, motion, sound, and light detection in parallel.</p>

<p>The brain is a swappable <b>agentic runtime</b> — five built-in options (OpenClaw, Hermes, PicoClaw, Codex, Claude Code) covering Claude, GPT, Gemini, and Qwen backends. Each runtime reads plain-text <code>SKILL.md</code> files and calls device APIs directly — no MCP wrapper needed. Realtime voice runs natively via Gemini Live, OpenAI Realtime, or Qwen Omni for sub-second speech-to-speech; complex requests delegate back to the main agent.</p>

<p>Hardware is a plugin: missing peripherals are skipped at init, so the same OS image runs a 5-DOF desk lamp and a quadruped robot alike. Skills address <b>capabilities</b>, not hardware — a "come here" skill works on any device that can move.</p>

---

<div style="height: 400px; overflow: hidden; display: flex; justify-content: center; align-items: center; margin-bottom: 16px;">
<img src="https://cdn.autonomous.ai/production/ecm/260701/thinking2.webp" alt="Autonomous Lamp" style="max-width: 100%; max-height: 100%;">
</div>

<p><b>Autonomous Lamp</b> — 5-DOF expressive desk robot. Audio, vision, motion, light, display, and sensing. The first reference device.</p>

<div style="height: 400px; overflow: hidden; display: flex; justify-content: center; align-items: center; margin-bottom: 16px;">
<img src="https://cdn.autonomous.ai/production/ecm/260707/intern2.webp" alt="Autonomous Intern" style="max-width: 100%; max-height: 100%;">
</div>

<p><b>Autonomous Intern</b> — always-on desk agent. Audio, sensing, and light. Pure voice + ambient intelligence.</p>

<p><b>Unitree Go2-W</b> — a different manufacturer's mobile robot running the identical OS. The Android playbook: same skills, different hardware.</p>

---

<div style="height: 350px; overflow: hidden; display: flex; justify-content: center; align-items: center; margin-bottom: 16px;">
<img src="https://cdn.autonomous.ai/production/ecm/260701/OS2.webp" alt="Autonomous OS" style="max-width: 100%; max-height: 100%;">
</div>

<p><b>25 built-in skills</b> — guard, mood, habit, wellbeing, music, camera, LED, servo, display, emotion, sensing, face enrollment, voice, computer-use, connectors, and more. Each skill is a plain-text <code>SKILL.md</code> the runtime reads and executes via HTTP.</p>

<p><b>Realtime voice (S2S)</b> — native speech-to-speech via Gemini Live, OpenAI Realtime, or Qwen Omni. Sub-second casual chat on the realtime model; complex tasks auto-delegate to the main agent. Local VAD + intent matching bypass the LLM entirely for known commands (~50 ms).</p>

<p><b>5 agent runtimes</b> — OpenClaw (Claude, full-featured), Hermes (Claude, 50% less memory), PicoClaw (Haiku, runs on Pi Zero), Codex (GPT-4), Claude Code (CLI-native). Swap via one config field.</p>

<p><b>Full system, not just a runtime</b> — WiFi setup wizard, React web dashboard, OTA bootstrap worker, MQTT bridge, multi-channel messaging, JSONL session memory with auto-summarization, and a 2-second sensing loop (motion, face, light, sound) that routes events to the agent.</p>

---

<p style="text-align: center;">
<a href="https://github.com/autonomous-ai/autonomous-os">GitHub</a> · <a href="https://www.autonomous.ai">Website</a>
</p>

</div>