Switchboard Core

A self-hosted extension platform. Identity, teams, permissions, workflows, and a package system. Everything else ships as installable extensions.

What This Is

Switchboard Core is the kernel. It provides the primitives that extensions build on: users, teams, groups, scoped credentials, a Starlark sandbox, workflow orchestration, notifications, and a package installer. It does not include AI chat, providers, personas, or any domain-specific features — those are all extension packages.

Stack

• Backend: Go / Gin
• Frontend: Preact + htm (no build step)
• Database: PostgreSQL (production) + SQLite (dev/test/edge)
• Sandbox: Starlark with capability-gated modules
• Deployment: Single Docker image, Kubernetes

Quick Start

git clone <repo-url> && cd switchboard-core
cp server/.env.example server/.env  # edit DB credentials
cd server && go run .
# → http://localhost:8080

Kernel Features

• Auth: Builtin password, mTLS (client cert), OIDC (Keycloak et al.)
• Teams & Groups: Horizontal isolation + vertical permissions
• Packages: Unified registry for surfaces, extensions, libraries, workflows
• Starlark Sandbox: Capability-gated server-side scripting for extensions
• Workflows: Staged processes with forms, review, and webhooks
• Connections: Scoped credential storage (global/team/personal), AES-256-GCM encrypted
• Notifications: In-app with per-type preferences
• Audit Log: All admin operations logged
• Object Storage: PVC or S3-compatible
• Multi-Replica HA: PG-backed WS tickets and rate limit counters

Documentation

• Architecture — kernel components and design reasoning
• Roadmap — current status and planned milestones
• Changelog — version history

Project Status

v0.1.0 (in progress) — kernel extracted from chat-switchboard v0.38.5. ~44K lines of chat/AI code removed, 27 kernel tables, 20 store interfaces. See ROADMAP.md for details.

License

Proprietary. All rights reserved.