SanctumOS Modules
SanctumOS is a modular, self-hosted agentic operating system: neuro-inspired components, MCP-native tooling, and optional inference routing. Each module can run alone or wire into the full stack.
Documentation: This page is mirrored on the site as Explore Modules. Deep dives live under Documentation — start with the architecture overview and quick start.
Updates: Release and product posts are on the blog — e.g. SanctumOS 1.2: Sensory Agents, Memory Enhancements, and More and Optimizing Agentic Workflows with Sanctum Middleware.
Core modules
Sanctum Letta MCP (SMCP)
Model Context Protocol server
The tool layer: a plugin-based MCP server so agents can call external tools through a standard protocol.
- Plugin-based architecture — drop a plugin in and it becomes available as MCP tools
- Full MCP protocol compliance and auto-discovery at startup
- Repository: sanctumos/smcp
Broca-2
Message processing middleware
The communication hub between agents and platforms (language-production metaphor). Bridges Telegram, web, CLI, and more.
- Multi-platform messaging, queues, echo / listen / live modes
- Multi-agent isolation
- Repository: sanctumos/broca
Sanctum Web Chat
Web interface bridge
Browser-based chat with agents without exposing your Sanctum server to the public internet.
- API-first design, polling-based real-time UX
- Admin monitoring and session management
- Repository: sanctumos/broca-web-client
Sanctum Router
Self-hosted inference proxy (“Entorhinal Cortex”)
OpenAI-compatible API that routes LLM traffic across providers with policy-based gating and credit-aware failover.
/v1/chat/completions,/v1/models,/v1/embeddings- Venice, Featherless, local servers, and more
- Repository: sanctumos/sanctum-router
Cochlea
Audio input pipeline (research release)
Hearing pathway for agents — compatible with Thalamus, Broca, or Letta-shaped inputs.
- Research release — APIs may change
- Repository: sanctumos/cochlea
SMCP plugin ecosystem
SMCP loads standalone plugin repos from plugins/; each plugin’s commands become MCP tools. See the full SMCP Plugins page for install notes and behavior.
| Plugin | Description | Repo |
|---|---|---|
| smcp-cursor-cli | Cursor CLI in headless / non-interactive agent runs | sanctumos/smcp-cursor-cli |
| smcp-doc-manager | Letta sources/folders admin, markdown → PDF/DOCX | sanctumos/smcp-doc-manager |
| smcp-image-analysis | Image interpretation via Venice AI vision API | sanctumos/smcp-image-analysis |
| smcp-gmail | Gmail API (list, read, send, labels) | sanctumos/smcp-gmail |
| smcp-plugin-github | GitHub CLI (gh) and Git CLI wrappers |
sanctumos/smcp-plugin-github |
| smcp-moltbook | Moltbook social network for AI agents | sanctumos/smcp-moltbook |
| smcp-bitlaunch.io | BitLaunch cloud server provisioning | sanctumos/smcp-bitlaunch.io |
Platform, ecosystem, and research
Beyond core modules, the org ships installers, reference apps, and research releases. Full narrative: Ecosystem overview.
Infrastructure & tooling
| Project | Description | Repo |
|---|---|---|
| Sanctum Installer | Early-alpha automated stack setup (WSL, Ubuntu, Raspbian) | sanctumos/installer |
| Code Buddy | GitHub webhooks + MCP server for dev activity awareness | sanctumos/code-buddy |
| Origin Conversation | ChatGPT export search + MCP tools | sanctumos/origin_conversation |
| Venice Billing Monitor | Venice billing → Letta memory block updates | sanctumos/sanctum-venice-billing-monitor |
Reference applications
| Project | Description | Repo |
|---|---|---|
| Sanctum CRM | AI-first, MCP-native CRM reference architecture | sanctumos/sanctum-crm |
| Clawed Road | Marketplace: EVM payments, PHP + Python, agent API | sanctumos/clawedroad |
| Sanctum Social | Social media management and automation | sanctumos/sanctum-social |
| Sanctum DMS | Dealer Management System (API-first, PHP + SQLite) | sanctumos/sanctum-dms |
Research releases
| Project | Role | Repo / doc |
|---|---|---|
| Thalamus | Input preprocessing hub (research) | sanctumos/thalamus · component doc |
| Cochlea | Audio input pipeline (research) | module doc · sanctumos/cochlea |
Suggested installation order
- Letta (or your agent runtime) — foundation
- Sanctum Letta MCP — tools
- Broca-2 — messaging layer
- Sanctum Web Chat — optional UI
- Sanctum Router — optional multi-provider inference
Or try the Sanctum Installer (early alpha) for an automated path. Per-module steps: Installation guide.
Configuration patterns
- Standalone — run one module alone
- Integrated — wire SMCP, Broca, Router, and UIs together
- Custom — mix only what you need
SanctumOS modules combine into a self-hosted platform for agent communication, tools, and inference — with docs and plugins evolving alongside the stack.