RealizeOS

The AI operations system for your business.
Coordinated AI agents that understand your venture, remember your preferences,
and execute multi-step workflows — not just another chatbot.

⚡ Quickstart · 🏗️ Architecture · ✨ Features · 🔌 MCP Server · 💻 CLI Reference · 🚀 Self-Host · 🤝 Contribute

What is RealizeOS?

RealizeOS is a self-hosted AI operations system that gives your business a coordinated team of AI agents. Unlike generic chatbots, RealizeOS agents know your venture, run multi-step workflows, route to the optimal model, and respect governance with approval gates and audit logs.

🆕 What's New in v5.5.0

v5.5.0 marks the open-source relaunch under BSL 1.1 — free core; monetize via guided installation sessions + vertical consulting. The positioning thesis:

You own the Heart (FABRIC knowledge graph + event log + identity) forever; agent runtimes, models, channels, and even the dashboard are swappable adapters; local-first.

Shipped

Roadmap (coming)

Voice channel (STT/TTS) · Full Workspace UI redesign · Cytoscape visual graph · React Native mobile companion · Host-satellite sync

📖 Full details: docs/v5.5.0/ · Claims verification: SITE-CLAIMS.md

⚡ Quick Start

git clone https://github.com/SufZen/RealizeOS-5.git && cd RealizeOS-5
cp .env.example .env       # Add your API key(s)
docker compose up --build   # Dashboard → http://localhost:8080

docker run -d -p 8080:8080 -v realizeos-data:/app/data ghcr.io/sufzen/realizeos-5:latest

pip install realize-os
realize-os init --template consulting
realize-os serve
# Dashboard → http://localhost:8080

npx @realize-os/cli init my-business
cd my-business && npx @realize-os/cli start

curl -fsSL https://raw.githubusercontent.com/SufZen/RealizeOS-5/main/scripts/install.sh | bash

irm https://raw.githubusercontent.com/SufZen/RealizeOS-5/main/scripts/install.ps1 | iex

📖 Full setup guide: QUICKSTART.md · Production: Self-Hosting Guide

✨ Key Features

🧠 FABRIC Knowledge System

Every venture's AI knowledge is organized into six layers:

🤖 Multi-LLM Routing

The engine classifies every task and selects the optimal model:

Providers auto-discovered at startup. Supports Claude, Gemini, OpenAI, and Ollama (local).

🔧 Agent System

• Composable agents with scope, inputs, outputs, guardrails, and tools
• Pipelines — sequential execution with Dev-QA retry loops
• 7 handoff types — standard, QA-pass/fail, escalation, phase-gate, sprint, incident
• Hot-reload — filesystem-watched agent registry
• Per-agent SOUL — persistent identity: role, personality, expertise, communication style
• Tool gating — per-agent allowlists/denylists

🧩 Extension System

🛠️ Tool Ecosystem

📋 Business Templates

Pre-built venture configurations:

consulting · agency · portfolio · saas · ecommerce · accounting · coaching · freelance

realize-os init --template consulting

🔌 MCP Server

RealizeOS ships a built-in MCP server so any MCP-speaking agent can use it as a second brain:

• 24 tools across 4 families: Chat & Status, KB Read, Ops, Admin
• HTTP+SSE transport — works with Claude Desktop, Cursor, n8n, cloud routines
• Same auth — Bearer JWT or API key, same roles and audit logs
• Gated access — KB, ops, and admin tools independently toggleable

realize-os mcp serve --port 8080        # Start API + MCP together
realize-os mcp token --user owner       # Issue a bearer token

📖 Full details: docs/mcp-server.md

💻 Operator CLI

The realize-os CLI is a first-class operator interface:

realize-os serve                                # Start API + dashboard
realize-os chat "What's the pipeline status?"   # Quick query
realize-os repl --system realization-il          # Interactive REPL
realize-os kb search "investment thesis"         # Search knowledge base
realize-os config profile add prod --endpoint https://my-vps:8080

Both realize-os (pip-installed) and python cli.py (source checkout) work identically.

📖 Full command reference: docs/cli-reference.md

🛡️ Security & Governance

• 5-layer security middleware: Security headers → Audit → Rate limiting → Injection guard → JWT auth
• RBAC with 6 roles: owner, admin, operator, user, viewer, guest
• Prompt injection scanner — pattern + heuristic + Unicode normalization
• Human-in-the-loop approval gates for consequential actions
• Audit logging — JSONL persistent logs with SSE streaming
• Secret redaction in error responses and logs

📖 Documentation

Requirements

• Python 3.11+ (3.12+ recommended)
• At least one LLM API key (Anthropic, Google, OpenAI, or Ollama)
• Docker 24.0+ (optional, for containerized deployment)
• Node.js 20+ (optional, for dashboard development)

Community

• 🐛 Report a Bug
• 💡 Request a Feature
• 📖 Read the Docs
• ⭐ Star the Repo

License

RealizeOS is licensed under the Business Source License 1.1.

• ✅ Free to use, modify, and self-host
• ✅ Free for internal business operations
• ✅ Converts to Apache 2.0 on March 26, 2030
• ❌ Cannot offer as a hosted/managed service without a commercial license

For commercial licensing inquiries, contact realizeos@realization.co.il.

Built by Realization

RealizeOS is designed and built by Realization, which runs its own research, documentation and coordination on it.

• Case study: realization.world/work/realizeos
• Setup and implementation for your business: realization.world/advisory