Documentation

Build and operate accountable AI applications with Symbia Stack.

Getting Started

Quickstart

Prerequisites, Docker or local run, and how to verify the stack is up

Startup script

First-run setup, fast restart, fresh database, forced rebuild

Symbia Script

The graph language: grammar, interpolation, and where it lives

MCP server

Drive the local stack over stdio MCP from any compatible client

Core Concepts

The app model

An app as a distributable artifact — manifest, lifecycle, isolation

Entity Directory

Unified identity table for users, agents, and services

Contracts

Explicit service-to-service authorization

Dual Principal

User and agent authenticated on every request

Graphs, not code

Declarative JSON DAGs, topologically ordered, durable across restarts

Stream control

Pause, resume, preempt, and handoff mid-generation

Services Reference

Identity

Authentication, authorization, Entity Directory, credential vault

Logging

Structured logs, metrics, traces, AI analysis

Catalog

Versioned resource registry — services, assistants, graphs, apps

Assistants

AI workflow orchestration, rule engine, @mention routing

Messaging

Real-time WebSocket conversations with stream control

Runtime

Dataflow graph execution with durable, resumable executions

Integrations

LLM provider gateway with normalized responses and usage tracking

Models

Local model serving and catalog

Network

SDN mesh, contract-based routing, policy enforcement

Control Center

Operator console — services, catalog, graphs, logs

Authentication, authorization, Entity Directory, Credential Vault

Logging

Structured logs, metrics, traces, AI analysis

Catalog

Versioned resource registry for services, assistants, workflows

Assistants

AI workflow orchestration, rule engine, @mention routing

Messaging

Real-time WebSocket conversations with stream control

Runtime

Dataflow graph execution engine with state persistence

Integrations

LLM provider gateway (OpenAI, Anthropic, HuggingFace)

Network

SDN mesh, contract-based routing, policy enforcement

Libraries

@symbia/sys

Service registry, port resolution, Symbia Script parser

@symbia/http

Express server factory with health checks and graceful shutdown

@symbia/db

Drizzle ORM wrapper, PostgreSQL and pg-mem dual mode

@symbia/relay

SDN client for publishing and subscribing to events

@symbia/id

Identity client for token validation

@symbia/auth

Shared authentication middleware

@symbia/logging-client

Telemetry SDK for logs, metrics, and traces

@symbia/messaging-client

Messaging client over Socket.IO

@symbia/catalog-client

Catalog client for resource lookup and registration

@symbia/md

Markdown documentation generator

@symbia/seed

Development seed data utilities

symbia-mcp-server

stdio MCP server over a running local stack

Guides

Building a Custom Assistant

Rules, action handlers, and @mention routing

Authoring Graphs

Symbia Script grammar, interpolation, and the component library

Packaging an App

Manifest, lifecycle, and isolation for a distributable app

API Defect Ledger

Platform defects found by building through the API alone

API Reference

Identity Service

POST /api/auth/login

POST /api/auth/introspect

POST /api/auth/agent/login

GET /api/auth/agent/me

GET /api/entities/{id}

POST /api/entities/resolve

POST /api/credentials

GET /api/auth/keys

Integrations Service

POST /api/integrations/execute

GET /api/integrations/providers

GET /api/integrations/providers/{provider}/models

GET /api/integrations/models

GET /api/integrations/capabilities

Health and service documentation

Health and documentation routes are published per service. A missing route is reported as unmeasured; it is not proof that a service is down or healthy.

GET /health/live (where published)

GET /health/ready (where published)

GET /docs/llms.txt (where published)

Ready to build?

Clone the repo and start building AI-native applications today.