SanctumOS Documentation
SanctumOS is a modular, self-hosted agentic operating system for AI agent communication and management.
đ¯ Quick Overview
- Self-Hosted: Your data stays on your infrastructure
- Modular: Mix and match components to fit your needs
- Neuro-Inspired: Components map to cognitive functions
- Extensible: Plugin-based system for unlimited customization
đī¸ Architecture
SanctumOS follows a neuro-inspired architecture that maps software components to cognitive functions. For a complete understanding of the system architecture, see our comprehensive architecture documentation.
đ Core Modules
- Modules Overview - Complete overview of all SanctumOS modules
- Sanctum Letta MCP - Model Context Protocol Server
- Broca-2 - Message Processing Middleware
- Sanctum Web Chat - Web Interface Bridge
đ Quick Start
Prerequisites: Before getting started with SanctumOS, you'll need to install the Docker instance of Letta to provide the foundation for your AI agent infrastructure.
>
đĄ Pro Tip: Run each module (including Letta) in separate screen sessions to keep them running in the background and easily accessible for monitoring and management.
- Master Sanctum Installer - Coming soon! One-click installation for complete SanctumOS deployment
- Individual Module Installation - Follow the installation instructions in each repository:
- Sanctum Letta MCP
- Broca-2
- Sanctum Web Chat
đ§ Configuration
- Multi-Agent Setup - Running multiple agents
đ Why Self-Hosted AI Matters
SanctumOS represents a fundamental shift from cloud-based AI to end-to-end self-hosted AI systems. This approach provides critical advantages that cloud implementations simply cannot match:
Complete Data Sovereignty
Your conversations, documents, and AI interactions never leave your infrastructure. Unlike cloud AI services that store your data on external servers, SanctumOS ensures your information remains under your complete control.
Zero External Dependencies
No reliance on third-party APIs, external services, or internet connectivity for core functionality. Your AI agents work entirely within your environment, eliminating the risks of service outages, API changes, or vendor lock-in.
Transparent Operations
Every decision, every response, every piece of data processing happens on your hardware with full visibility. You can audit, monitor, and understand exactly how your AI systems are operating.
Privacy by Design
No data collection, no telemetry, no usage tracking. Your AI interactions are private by default, not as an afterthought or optional feature.
Customization Without Limits
Modify, extend, and customize every aspect of your AI system without restrictions. Cloud AI services limit what you can change; self-hosted AI gives you complete freedom.
Cost Predictability
If you host your own inference, there's no per-API-call pricing, no usage limits, no surprise bills. Once deployed, your AI infrastructure runs on your terms with predictable costs.
Regulatory Compliance
Meet data residency requirements, industry regulations, and organizational policies without compromise. Your data stays where you need it to be.
đ Documentation
Getting Started
- Quick Start - Your first steps with SanctumOS
Architecture & Components
- Architecture Overview - Complete system architecture
- Naming Rubric - Consistent terminology guidelines
- Components - Detailed component documentation
Advanced Topics
- Troubleshooting - Common issues and solutions
- Contributing - How to contribute to SanctumOS
đ¤ Community & Support
- GitHub: github.com/sanctumos
- Email: sanctumos@rizzn.com
đ License
- Code: AGPLv3 - GNU Affero General Public License v3.0
- Documentation: CC-BY-SA 4.0 - Creative Commons Attribution-ShareAlike 4.0
SanctumOS - Empowering AI agents with secure, modular communication.