Documentation

Welcome to the Sophon documentation. Sophon is an enterprise-grade AI Personal Assistant platform built on .NET 10. It ships as a modular monolith with clients for web, desktop, mobile, and CLI; a full orchestration engine with planning and approvals; and an extensibility surface that spans skills, workflows, plugins, MCP, and apps.

New here? Start with Installation, then read Architecture Overview for the mental model.

Getting Started

• Installation — Docker, native .NET, or CLI
• Configuration — add your first LLM provider
• First Agent — create and personalize an agent
• Connect a Channel — WhatsApp, Telegram, Slack, and 7 more

Core Concepts

• Architecture Overview — Gateway, Core, clients, sandboxes
• Agents & SOUL — personalities, tool allowlists, multi-agent routing
• Orchestration Pipeline — the 12 middlewares that run every turn
• Planning — how complex requests get decomposed and executed
• Approval Gates & Risk Levels — human-in-the-loop for irreversible actions
• Tiers — Personal vs Pro vs Enterprise feature matrix

Features

• Memory — user + agent memory, daily logs, semantic search
• Workflows — visual and AI-authored automation
• Skills — extend Sophon with sandboxed tools
• Documents — upload, index, Q&A across PDFs/DOCX/images/audio
• Connections — OAuth and API-key integrations
• Approval Gates — gate high-risk tool calls

Channels

Connect Sophon to the messaging platforms your users already live in:

• Channels Overview — routing, attachments, and the full channel list
• WebChat, Telegram, Discord, Slack, WhatsApp, Email, Teams, Signal, Matrix, SMS

API Reference

• REST API — HTTP endpoints
• SignalR — real-time hubs
• Webhooks — inbound + outbound events
• CLI — command-line reference
• Skill Manifest — skill format
• Workflow JSON — workflow format

Self-Hosting

• Docker — Docker Compose for all three tiers
• Native (.NET) — run as a standalone process
• Kubernetes — Helm chart deployment
• Configuration — appsettings.json reference
• SSL & Reverse Proxy — TLS, nginx, Caddy
• Backup & Upgrade — operational procedures

Enterprise

• SSO & Authentication — OIDC integration
• RBAC — roles and permissions
• Audit Logging — immutable action trail
• Multi-Tenancy — tenant isolation

More

• Built-in Skills — browse bundled skills and tools
• Sophon Mobile — iOS & Android companion app