The AI OS — Five open-source AI agents. One operating system.

The stack

Five projects, one system

Each stays intact and upgradable. The AI OS installs, configures, and wires them — it doesn't fork them.

⌨️

opencode

The coding-agent engine — a headless server + SDK the other agents can call.

:4096

☤

hermes

Autonomous agent with memory, cron, a learning loop, and its own dashboard.

:9119

🦞

openclaw

Multi-channel messaging gateway and plugin host — Telegram, Discord, Slack…

:18789

👥

CrewAI

Multi-agent orchestration — role-based crews that plan and delegate, with a tool to call the other agents.

:4788

🧬

LifeOS

Shared identity + skills, mounted into the agents so they know you.

skills layer

Glued together by the AIOS Hub (the Control Room, :8787), the openclaw-os generative-UI dashboard, and OpenUI — mounted into every agent.

Why it's nice

What you get

⚡

One command to rule them all

aios setup installs bun / pnpm / uv / Node, every project's deps, builds what needs building, and wires it together. Idempotent.

🔑

One key, every agent

Set your provider + API key once in .env. The AI OS maps it into each project's config — change it in one place.

💬

One Control Room

Chat with any agent — Brain, CrewAI, opencode — or broadcast to all. Watch them call each other, with hermes & openclaw-os embedded and OpenUI results rendered live.

🩺

Doctor that tells you the fix

aios doctor checks toolchains, config, deps and ports — and prints the exact command to fix each problem.

🧪

Unified testing & debugging

aios test --smoke drives the whole stack end-to-end. aios debug dumps resolved config with secrets masked.

🪟

Windows-first, cross-platform

Built and verified on Windows 11 (PowerShell), with POSIX / macOS / Linux / WSL parity. Zero-dependency Python core.

The OpenClaw + Hermes playbook, unified

Everything, baked in

🖥️

Full machine control

Every agent gets shell, files and network on the host — each via its project's own switch. Paired with a token gate, CSRF/rebinding guards, guardrails and a full audit log, so it isn't the CVE-2026-25253 footgun.

📡

Multi-channel gateway

One daemon bridges 28 messaging apps — WhatsApp, Telegram, Discord, Slack, Signal, Matrix, Teams, iMessage and more. Paste a token in the Channels grid; it goes live.

⚙

Task Brain

One SQLite-backed scheduler unifies cron jobs, interval prompts and background shell commands. Every run recorded; tasks survive restarts — like k8s for agent tasks.

🔀

TaskFlow

Durable multi-step flows that chain agents. State commits after every step, so a crash or restart resumes where it left off — with full revision history.

🧠

Active Memory

A memory sub-agent fires on every turn — free FTS5 recall + async fact-extraction — so the agents learn your workflow, not just read memory at session start.

🎓

Self-improving skills

After a task that ran commands, a Curator judges whether it taught a reusable procedure and writes a SKILL.md every agent then mounts. Plus ClawHub-style installs and aios migrate from OpenClaw.

How it fits together

Architecture

💬 AIOS Hub · the Control Room :8787 talk to everything · broadcast · live status · interconnect

▲ routes to & between every agent

opencode :4096 coding engine

hermes :9119 autonomous · memory · cron

openclaw :18789 channels + hosts openclaw-os

CrewAI :4788 multi-agent crews

▲ agents call each other via the Hub

LifeOS skills + OpenUI context mounted into every agent · openclaw-os renders the UI

Single source of truth: aios.config.yaml + .env, rendered into each project's native config. Single control surface: ./aios <command>.

60 seconds

Quickstart

One-line install

Clones the repo, installs toolchains + every project's deps, builds, and wires the dashboard.

Add your key

Run aios setup --force — one provider key powers all four agents.

Start

Brings every service up with health checks, then aios url opens the dashboard.

One-line install — Linux / macOS / WSL

# clones, installs toolchains + deps, builds, wires everything
curl -fsSL https://raw.githubusercontent.com/ZDStudios/AIOS/main/install.sh | bash

One-line install — Windows (PowerShell)

irm https://raw.githubusercontent.com/ZDStudios/AIOS/main/install.ps1 | iex

Then — add your key & launch

cd ~/AIOS
./aios setup --force   # enter provider + API key
./aios start           # ✓ opencode  ✓ hermes  ✓ openclaw
./aios url             # open the dashboard

The control surface

Command reference

aios setupInstall toolchains + deps, run the secrets wizard, render config, build, mount skills, wire the dashboard.

aios start [svc]Start service(s), wait on health checks, keep unified logs.

aios stop [svc]Stop service(s); kills the whole process tree — no orphans.

aios statusTable of each service: state, port, PID, health.

aios doctorDiagnose tools, config, deps and ports — with the exact fix for each.

aios test --smokeRun test suites, or drive the whole stack end-to-end.

aios logs [svc]Tail a service log from .aios/logs/.

aios urlPrint the dashboard + service URLs.