---
layout: default
title: Home
nav_order: 1
description: "Symbiont: AI-native, privacy-first programming language and agent framework"
permalink: /
---

# Symbiont Documentation
{: .fs-9 }

AI-native, privacy-first programming language and agent framework for autonomous, policy-aware software development.
{: .fs-6 .fw-300 }

[Get started now](#getting-started){: .btn .btn-primary .fs-5 .mb-4 .mb-md-0 .mr-2 }
[View on GitHub](https://github.com/thirdkeyai/symbiont){: .btn .fs-5 .mb-4 .mb-md-0 }

---

## 🌐 Other Languages
{: .no_toc}

**English** | [中文简体](index.zh-cn.md) | [Español](index.es.md) | [Português](index.pt.md) | [日本語](index.ja.md) | [Deutsch](index.de.md)

---

## 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

```bash
# 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

```rust
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

```mermaid
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

### v1.0.0 Released

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

- **Scheduling**: Cron-based task execution with session isolation, delivery routing, and dead-letter queues
- **Session Isolation**: Ephemeral, shared, or fully isolated agent contexts
- **Delivery Routing**: Output to Stdout, LogFile, Webhook, Slack, Email, or custom channels
- **Policy Enforcement**: Security and compliance gates with time-window and capability checks
- **AgentPin Identity**: Cryptographic agent identity verification via ES256 JWTs
- **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
- Performance optimization and intelligent caching

---

## Community

- **Documentation**: Comprehensive guides and API references
- [API Reference](api-reference.md)
- [Scheduling Guide](scheduling.md)
- [HTTP Input Module](http-input.md)
- **Issues**: [GitHub Issues](https://github.com/thirdkeyai/symbiont/issues)
- **Discussions**: [GitHub Discussions](https://github.com/thirdkeyai/symbiont/discussions)
- **License**: Open source software by ThirdKey

---

## Next Steps

<div class="grid grid-cols-1 md:grid-cols-3 gap-6 mt-8">
  <div class="card">
    <h3>🚀 Get Started</h3>
    <p>Follow our getting started guide to set up your first Symbiont environment.</p>
    <a href="/getting-started" class="btn btn-outline">Quick Start Guide</a>
  </div>
  
  <div class="card">
    <h3>📖 Learn the DSL</h3>
    <p>Master the Symbiont DSL for building policy-aware agents.</p>
    <a href="/dsl-guide" class="btn btn-outline">DSL Documentation</a>
  </div>
  
  <div class="card">
    <h3>🏗️ Architecture</h3>
    <p>Understand the runtime system and security model.</p>
    <a href="/runtime-architecture" class="btn btn-outline">Architecture Guide</a>
  </div>
</div>