The Modular, Self-Hosted Agentic Operating System

SanctumOS Documentation

SanctumOS is a modular, self-hosted agentic operating system for AI agent communication and management. It provides a neuro-inspired cognitive architecture where software components map to brain functions, giving agents memory consolidation, task orchestration, multi-platform communication, and tool access through the Model Context Protocol (MCP).

Quick Overview

  • Self-Hosted: Your data stays on your infrastructure — no third-party cloud dependencies
  • Modular: Mix and match components to fit your needs
  • Neuro-Inspired: Components map to cognitive functions (Thalamus, Broca, Basal Ganglia, etc.)
  • MCP-Native: Tool integration through the Model Context Protocol standard
  • Extensible: Plugin-based system across the entire stack

Architecture

SanctumOS follows a neuro-inspired architecture that maps software components to cognitive functions. For a complete understanding of the system architecture, see the Architecture Overview.

Core Modules

Module Role Repo
Sanctum Letta MCP (SMCP) Plugin-based MCP server — the tool layer sanctumos/smcp
Broca-2 Message processing middleware — the speech center sanctumos/broca
Sanctum Web Chat Web interface bridge for browser-based agent chat sanctumos/broca-web-client
Sanctum Router Self-hosted OpenAI-compatible inference proxy sanctumos/sanctum-router
Cochlea Audio input pipeline (research release) sanctumos/cochlea

SMCP Plugin Ecosystem

SMCP's plugin architecture has grown into a rich ecosystem. Each plugin exposes domain-specific tools to any MCP-connected agent. See the full SMCP Plugins overview for details.

Plugin What it does
smcp-cursor-cli Run Cursor CLI agent sessions in headless mode
smcp-doc-manager Letta sources/folders admin, markdown → PDF/DOCX export
smcp-image-analysis Image interpretation via Venice AI vision API
smcp-gmail Gmail as MCP tools (list, read, send, label)
smcp-plugin-github GitHub CLI and Git wrappers for MCP
smcp-moltbook Social network for AI agents (Moltbook)
smcp-bitlaunch.io BitLaunch cloud server provisioning

Getting Started

Prerequisites: Install the Docker instance of Letta to provide the foundation for your AI agent infrastructure.

>

Tip: Run each module (including Letta) in separate screen sessions to keep them running in the background and easily accessible.

Ecosystem & Applications

Beyond core infrastructure, SanctumOS includes reference applications and utilities built on the stack. See the Ecosystem Overview for the full catalog.

Project Description
Sanctum CRM AI-first, MCP-native CRM reference architecture
Clawed Road Marketplace stack: EVM payments, PHP + Python, agent API
Code Buddy GitHub webhook processor + MCP server for agent dev awareness
Origin Conversation ChatGPT history search/export + MCP server
Venice Billing Monitor Venice AI billing → Letta agent memory block updates
Sanctum Social Social media management and automation
Sanctum DMS Dealer Management System (API-first, PHP + SQLite)

Configuration

Why Self-Hosted AI Matters

SanctumOS represents a fundamental shift from cloud-based AI to end-to-end self-hosted AI systems.

  • Complete Data Sovereignty — your conversations, documents, and AI interactions never leave your infrastructure.
  • Zero External Dependencies — no reliance on third-party APIs for core functionality. Your AI agents work entirely within your environment.
  • Transparent Operations — every decision, every response, every piece of data processing happens on your hardware with full visibility.
  • Privacy by Design — no data collection, no telemetry, no usage tracking.
  • Customization Without Limits — modify, extend, and customize every aspect of your AI system without restrictions.
  • Cost Predictability — if you host your own inference, there's no per-API-call pricing, no usage limits, no surprise bills.
  • Regulatory Compliance — meet data residency requirements, industry regulations, and organizational policies without compromise.

Documentation

Getting Started

Architecture & Components

Modules & Plugins

Ecosystem

Reference

Community & Support

License

SanctumOS — Empowering AI agents with secure, modular communication.