Symbiont Documentation

AI-native agent framework for building autonomous, policy-aware agents with scheduling, channel adapters, and cryptographic identity โ€” built in Rust.

Get started now View on GitHub

๐ŸŒ Other Languages

English ไธญๆ–‡็ฎ€ไฝ“ Espaรฑol Portuguรชs ๆ—ฅๆœฌ่ชž Deutsch

What is Symbiont?

Symbiont is an AI-native agent framework for building autonomous, policy-aware agents that safely collaborate with humans, other agents, and large language models. It provides a complete production stack โ€” from a declarative DSL and scheduling engine to multi-platform channel adapters and cryptographic identity verification โ€” all built in Rust for performance and safety.

Key Features

  • ๐Ÿ›ก๏ธ Security-First Design: Zero-trust architecture with multi-tier sandboxing, policy enforcement, and cryptographic audit trails
  • ๐Ÿ“‹ Declarative DSL: Purpose-built language for defining agents, policies, schedules, and channel integrations with tree-sitter parsing
  • ๐Ÿ“… Production Scheduling: Cron-based task execution with session isolation, delivery routing, dead-letter queues, and jitter support
  • ๐Ÿ’ฌ Channel Adapters: Connect agents to Slack, Microsoft Teams, and Mattermost with webhook verification and identity mapping
  • ๐ŸŒ HTTP Input Module: Webhook server for external integrations with Bearer/JWT auth, rate limiting, and CORS
  • ๐Ÿ”‘ AgentPin Identity: Cryptographic agent identity verification via ES256 JWTs anchored to well-known endpoints
  • ๐Ÿ” Secrets Management: HashiCorp Vault integration with encrypted file and OS keychain backends
  • ๐Ÿง  Context & Knowledge: RAG-enhanced knowledge systems with vector search (Qdrant) and optional local embeddings
  • ๐Ÿ”— MCP Integration: Model Context Protocol client with SchemaPin cryptographic tool verification
  • โšก Multi-Language SDKs: JavaScript and Python SDKs for full API access including scheduling, channels, and enterprise features
  • ๐Ÿ—๏ธ High Performance: Rust-native runtime optimized for production workloads with async execution throughout

Getting Started

Quick Installation 

# Clone the repository
git clone https://github.com/thirdkeyai/symbiont.git
cd symbiont

# Build unified symbi container
docker build -t symbi:latest .

# Or use pre-built container
docker pull ghcr.io/thirdkeyai/symbi:latest

# Test the system
cargo test

# Test the unified CLI
docker run --rm symbi:latest --version
docker run --rm -v $(pwd):/workspace symbi:latest dsl parse --help
docker run --rm symbi:latest mcp --help

Your First Agent 

metadata {
    version = "1.0.0"
    author = "developer"
    description = "Simple analysis agent"
}

agent analyze_data(input: DataSet) -> Result {
    capabilities = ["data_analysis"]
    
    policy secure_analysis {
        allow: read(input) if input.anonymized == true
        deny: store(input) if input.contains_pii == true
        audit: all_operations with signature
    }
    
    with memory = "ephemeral", privacy = "high" {
        if (validate_input(input)) {
            result = process_data(input);
            audit_log("analysis_completed", result.metadata);
            return result;
        } else {
            return reject("Invalid input data");
        }
    }
}

Architecture Overview 

graph TB
    A[Governance & Policy Layer] --> B[Core Rust Engine]
    B --> C[Agent Framework]
    B --> D[Tree-sitter DSL Engine]
    B --> E[Multi-Tier Sandboxing]
    E --> F[Docker - Low Risk]
    E --> G[gVisor - Medium/High Risk]
    B --> I[Cryptographic Audit Trail]

    subgraph "Scheduling & Execution"
        S[Cron Scheduler]
        H[Session Isolation]
        R[Delivery Router]
    end

    subgraph "Channel Adapters"
        SL[Slack]
        TM[Teams]
        MM[Mattermost]
    end

    subgraph "Context & Knowledge"
        J[Context Manager]
        K[Vector Database]
        L[RAG Engine]
    end

    subgraph "Secure Integrations"
        M[MCP Client]
        N[SchemaPin Verification]
        O[Policy Engine]
        P[AgentPin Identity]
    end

    C --> S
    S --> H
    S --> R
    R --> SL
    R --> TM
    R --> MM
    C --> J
    C --> M
    J --> K
    J --> L
    M --> N
    M --> O
    C --> P

Use Cases

Development & Research

  • Secure code generation and automated testing
  • Multi-agent collaboration experiments
  • Context-aware AI system development

Privacy-Critical Applications

  • Healthcare data processing with privacy controls
  • Financial services automation with audit capabilities
  • Government and defense systems with security features

Project Status

v1.0.0 Stable

Symbiont v1.0.0 is the first stable release, delivering a complete AI agent framework with production-grade capabilities:

  • Scheduling Engine: Cron-based task execution with session isolation, delivery routing, dead-letter queues, jitter, and concurrency limits
  • Channel Adapters: Slack (community), Microsoft Teams and Mattermost (enterprise) with webhook verification and HMAC signing
  • Channel Management API: REST endpoints for adapter lifecycle โ€” register, start, stop, health checks, identity mapping, and audit logs
  • HTTP Input Module: Webhook server for external integrations with Bearer/JWT auth, rate limiting, and CORS
  • DSL Extensions: schedule and channel blocks for declarative scheduling and channel configuration
  • AgentPin Identity: Cryptographic agent identity verification via ES256 JWTs with domain-anchored well-known endpoints
  • Secrets Management: HashiCorp Vault, encrypted file, and OS keychain backends with runtime provider abstraction
  • Policy Enforcement: Security and compliance gates with time-window and capability checks
  • JavaScript & Python SDKs: Full API clients covering scheduling, channels, agents, and enterprise features
  • Observability: Prometheus-compatible metrics, structured audit events, and health endpoints

๐Ÿ”ฎ Planned Features

  • Multi-modal RAG support (images, audio, structured data)
  • Cross-agent knowledge synthesis and collaboration
  • Federated agent networks with cross-domain trust
  • Additional channel adapters (Discord, Matrix)

Community

Next Steps

๐Ÿš€ Get Started

Follow our getting started guide to set up your first Symbiont environment.

Quick Start Guide

๐Ÿ“– Learn the DSL

Master the Symbiont DSL for building policy-aware agents.

DSL Documentation

๐Ÿ—๏ธ Architecture

Understand the runtime system and security model.

Architecture Guide