Documentacion de Symbiont

Framework de agentes nativo de IA para construir agentes autonomos y conscientes de politicas con programacion de tareas, adaptadores de canal e identidad criptografica — construido en Rust.

Comenzar ahora Ver en GitHub

🌐 Otros idiomas

English 中文简体 Español Português 日本語 Deutsch

¿Que es Symbiont?

Symbiont es un framework de agentes nativo de IA para construir agentes autonomos y conscientes de politicas que colaboran de forma segura con humanos, otros agentes y modelos de lenguaje grandes. Proporciona una pila de produccion completa — desde un DSL declarativo y motor de programacion hasta adaptadores de canal multiplataforma e identidad criptografica verificable — todo construido en Rust para rendimiento y seguridad.

Caracteristicas Principales

  • 🛡️ Diseño Centrado en Seguridad: Arquitectura de confianza cero con sandboxing multinivel, aplicacion de politicas y rastros de auditoria criptograficos
  • 📋 DSL Declarativo: Lenguaje diseñado para definir agentes, politicas, programaciones e integraciones de canal con parseo tree-sitter
  • 📅 Programacion de Produccion: Ejecucion de tareas basada en cron con aislamiento de sesion, enrutamiento de entregas, colas de mensajes muertos y soporte de jitter
  • 💬 Adaptadores de Canal: Conecta agentes a Slack, Microsoft Teams y Mattermost con verificacion de webhook y mapeo de identidad
  • 🌐 Modulo de Entrada HTTP: Servidor webhook para integraciones externas con autenticacion Bearer/JWT, limitacion de velocidad y CORS
  • 🔑 Identidad AgentPin: Verificacion criptografica de identidad de agentes via ES256 JWTs anclados a endpoints well-known
  • 🔐 Gestion de Secretos: Integracion con HashiCorp Vault con backends de archivo cifrado y llavero del sistema operativo
  • 🧠 Contexto y Conocimiento: Sistemas de conocimiento mejorados con RAG con busqueda vectorial (LanceDB embebido por defecto, Qdrant opcional) y embeddings locales opcionales
  • 🔗 Integracion MCP: Cliente del Protocolo de Contexto de Modelo con verificacion criptografica de herramientas SchemaPin
  • ⚡ SDKs Multi-Lenguaje: SDKs de JavaScript y Python para acceso completo a la API incluyendo programacion, canales y funciones empresariales
  • 🔄 Bucle de Razonamiento Agentico: Ciclo Observe-Reason-Gate-Act (ORGA) con typestates, compuertas de politicas, circuit breakers, diario durable y puente de conocimiento
  • 🧪 Razonamiento Avanzado (orga-adaptive): Filtrado de perfiles de herramientas, deteccion de bucles atascados, pre-carga determinista de contexto y convenciones con alcance de directorio
  • 📜 Motor de Politicas Cedar: Integracion de lenguaje de autorizacion formal para control de acceso granular
  • 🏗️ Alto Rendimiento: Runtime nativo en Rust optimizado para cargas de trabajo de produccion con ejecucion asincrona completa

Primeros Pasos

Instalacion Rapida 

# 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

Tu Primer Agente 

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");
        }
    }
}

Vision General de la Arquitectura 

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]
        MD[Markdown Memory]
    end

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

    subgraph "Observability"
        MET[Metrics Collector]
        FE[File Exporter]
        OT[OTLP Exporter]
    end

    C --> S
    S --> H
    S --> R
    R --> SL
    R --> TM
    R --> MM
    C --> J
    C --> M
    C --> SK
    J --> K
    J --> L
    J --> MD
    M --> N
    M --> O
    C --> P
    C --> MET
    MET --> FE
    MET --> OT

Casos de Uso

Desarrollo e Investigacion

  • Generacion segura de codigo y pruebas automatizadas
  • Experimentos de colaboracion multi-agente
  • Desarrollo de sistemas de IA conscientes del contexto

Aplicaciones Criticas de Privacidad

  • Procesamiento de datos de salud con controles de privacidad
  • Automatizacion de servicios financieros con capacidades de auditoria
  • Sistemas gubernamentales y de defensa con caracteristicas de seguridad

Estado del Proyecto

v1.7.0 Estable

Symbiont v1.7.0 es la ultima version estable, que ofrece un framework completo de agentes de IA con capacidades de nivel de produccion:

  • Bucle de Razonamiento Agentico: Ciclo ORGA con typestates, conversacion multi-turno, inferencia en la nube y SLM, circuit breakers, diario durable y puente de conocimiento
  • Primitivas de Razonamiento Avanzado (orga-adaptive): Filtrado de perfiles de herramientas, deteccion de bucles atascados por paso, pre-carga determinista de contexto y convenciones con alcance de directorio
  • Motor de Politicas Cedar: Autorizacion formal via integracion del lenguaje de politicas Cedar (feature cedar)
  • Inferencia LLM en la Nube: Proveedor de inferencia en la nube compatible con OpenRouter (feature cloud-llm)
  • Modo Agente Autonomo: Una sola linea para agentes nativos de la nube con LLM + herramientas Composio (feature standalone-agent)
  • Backend Vectorial LanceDB Embebido: Busqueda vectorial sin configuracion — LanceDB por defecto, Qdrant opcional via feature flag vector-qdrant
  • Pipeline de Compactacion de Contexto: Compactacion por niveles con resumenes por LLM y conteo de tokens multi-modelo (OpenAI, Claude, Gemini, Llama, Mistral y mas)
  • Escaner ClawHavoc: 40 reglas de deteccion en 10 categorias de ataque con modelo de severidad de 5 niveles y lista blanca de ejecutables
  • Integracion Composio MCP: Conexion SSE con feature gate al servidor MCP de Composio para acceso a herramientas externas
  • Memoria Persistente: Memoria de agente respaldada en Markdown con hechos, procedimientos, patrones aprendidos y compactacion basada en retencion
  • Verificacion de Webhook: Verificacion HMAC-SHA256 y JWT con presets para GitHub, Stripe, Slack y personalizados
  • Endurecimiento de Seguridad HTTP: Enlace solo a loopback, listas de permitidos CORS, validacion JWT EdDSA, separacion de endpoint de salud
  • Metricas y Telemetria: Exportadores de archivos y OTLP con fan-out compuesto, trazado distribuido OpenTelemetry
  • Motor de Programacion: Ejecucion basada en cron con aislamiento de sesion, enrutamiento de entregas, colas de mensajes muertos y jitter
  • Adaptadores de Canal: Slack (comunidad), Microsoft Teams y Mattermost (enterprise) con firma HMAC
  • Identidad AgentPin: Identidad criptografica de agente via ES256 JWTs anclados a endpoints well-known
  • Gestion de Secretos: Backends de HashiCorp Vault, archivo cifrado y llavero del sistema operativo
  • SDKs de JavaScript y Python: Clientes API completos cubriendo programacion, canales, webhooks, memoria, habilidades y metricas

🔮 Hoja de Ruta v1.7.0

  • Integracion de agentes externos y soporte del protocolo A2A
  • Soporte RAG multi-modal (imagenes, audio, datos estructurados)
  • Adaptadores de canal adicionales (Discord, Matrix)

Comunidad

Proximos Pasos

🚀 Comenzar

Sigue nuestra guia de inicio para configurar tu primer entorno Symbiont.

Guia de Inicio Rapido

📖 Aprender el DSL

Domina el DSL de Symbiont para construir agentes conscientes de politicas.

Documentacion DSL

🏗️ Arquitectura

Comprende el sistema de tiempo de ejecucion y el modelo de seguridad.

Guia de Arquitectura