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.
SMCP 3.1.0 is live onmaster. Sanctum Letta MCP — the tool layer — shipped a production release with critical HTTP authentication hardening, config-driven governor profiles, structured tool errors, and installablesmcp/smcp-stdioentrypoints. Read the release post → · GitHub v3.1.0 · Module doc →
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. SMCP 3.1.0, SanctumOS 1.2, and Optimizing Agentic Workflows.
Core modules
Sanctum Letta MCP (SMCP)
Model Context Protocol server · 3.1.0 release notes →
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
- Session attach governor with JSON profiles (
SMCP_PROFILES) andsanctum__tools - HTTP/SSE auth: fail-closed external bind; STDIO for local MCP clients
- Repository: sanctumos/smcp · branch
master
Broca 3
Message processing middleware
The communication hub between agents and platforms (language-production metaphor). Bridges Telegram, web, CLI, local agent-to-agent spool, and more.
- Multi-platform messaging, queues, image handling, streaming with long-running tasks
- Letta client v1.0+ compliant, circuit breaker / retry, 1080-test suite
- Multi-agent isolation with per-agent DB, config, and logs
- 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 Tasks
API-first task management + embedded Ask Q
Reference application for the Sanctum stack: /api/ task & document system, SMCP plugin (tasks__), q-bridge + Ask Q Vernal on admin. First production use of the embedded agent chat modality.
- Directory projects, todo lists, attachments, audit logs
- Broca
q_vernal_webchat+ Letta Q Vernal + governor profiles (chatter/admin/full) - Repository: sanctumos/sanctum-tasks · live: tasks.decisionsciencecorp.com
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 |
|---|---|---|
| tasks (Sanctum Tasks) | Full Tasks API as MCP tools — tasks, documents, comments, bulk; @@TC0@@ profile for Ask Q | sanctumos/sanctum-tasks (smcp_plugin/) |
| 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 Tasks | API-first tasks + documents; Ask Q embedded chat; SMCP reference app | sanctumos/sanctum-tasks · module doc |
| 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 3 — 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.*