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
- Documentation: Comprehensive guides and API references
- API Reference
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- License: Open source software by ThirdKey
Next Steps
🚀 Get Started
Follow our getting started guide to set up your first Symbiont environment.
Quick Start Guide