Symbiont Documentation

AI-native, privacy-first programming language and agent framework for autonomous, policy-aware software development.

Get started now View on GitHub


What is Symbiont?

Symbiont represents the next evolution in software development — where AI agents and human developers collaborate securely, transparently, and effectively. It enables developers to build autonomous, policy-aware agents that can safely collaborate with humans, other agents, and large language models while enforcing zero-trust security, data privacy, and verifiable behavior.

Key Features

  • 🛡️ Security-First Design: Multi-tier sandboxing with Docker and gVisor
  • 📋 Policy-Aware Programming: Declarative security policies with runtime enforcement
  • 🔐 Enterprise Secrets Management: HashiCorp Vault integration with encrypted file backends
  • 🔑 Cryptographic Auditability: Complete operation logging with Ed25519 signatures
  • 🧠 Intelligent Context Management: RAG-enhanced knowledge systems with vector search
  • 🔗 Secure Tool Integration: MCP protocol with cryptographic verification
  • ⚡ High Performance: Rust-native implementation for production workloads

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 "Context & Knowledge"
        J[Context Manager]
        K[Vector Database]
        L[RAG Engine]
    end
    
    subgraph "Secure Integrations"
        M[MCP Client]
        N[Tool Verification]
        O[Policy Engine]
    end
    
    C --> J
    C --> M
    J --> K
    J --> L
    M --> N
    M --> O

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

✅ Completed Phases

  • Phase 1-3: Core infrastructure, agent framework, and security implementation
  • Phase 4: Context & knowledge systems with RAG capabilities
  • Phase 5: Secure MCP integration with tool verification
  • Phase 6: Enterprise secrets management with HashiCorp Vault integration

🔮 Planned Features

  • Multi-modal RAG support (images, audio, structured data)
  • Cross-agent knowledge synthesis and collaboration
  • Advanced learning capabilities with policy adaptation
  • Performance optimization and intelligent caching
  • Enhanced audit trails with blockchain integration

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