mirror of
https://github.com/RightNow-AI/openfang.git
synced 2026-07-30 06:32:17 +00:00
jaberjaber23
5692c96494
Open-source Agent OS built in Rust. - 14 crates, 1,767+ tests, zero clippy warnings - 7 autonomous Hands (Clip, Lead, Collector, Predictor, Researcher, Twitter, Browser) - 16 security systems (WASM sandbox, Merkle audit trail, taint tracking, Ed25519 signing, SSRF protection, secret zeroization, HMAC-SHA256 mutual auth, and more) - 30 pre-built agents across 4 performance tiers - 40 channel adapters (Telegram, Discord, Slack, WhatsApp, Teams, and 35 more) - 38 built-in tools + MCP client/server + A2A protocol - 26 LLM providers with intelligent routing and cost tracking - 60+ bundled skills with FangHub marketplace - Tauri 2.0 native desktop app - 140+ REST/WS/SSE API endpoints with Alpine.js dashboard - OpenAI-compatible /v1/chat/completions endpoint - One-command install, production-ready
106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# OpenFang Documentation
|
|
|
|
Welcome to the OpenFang documentation. OpenFang is the open-source Agent Operating System -- 14 Rust crates, 40 channels, 60 skills, 20 LLM providers, 76 API endpoints, and 16 security systems in a single binary.
|
|
|
|
---
|
|
|
|
## Getting Started
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Getting Started](getting-started.md) | Installation, first agent, first chat session |
|
|
| [Configuration](configuration.md) | Complete `config.toml` reference with every field |
|
|
| [CLI Reference](cli-reference.md) | Every command and subcommand with examples |
|
|
| [Troubleshooting](troubleshooting.md) | Common issues, FAQ, diagnostics |
|
|
|
|
## Core Concepts
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Architecture](architecture.md) | 12-crate structure, kernel boot, agent lifecycle, memory substrate |
|
|
| [Agent Templates](agent-templates.md) | 30 pre-built agents across 4 performance tiers |
|
|
| [Workflows](workflows.md) | Multi-agent pipelines with branching, fan-out, loops, and triggers |
|
|
| [Security](security.md) | 16 defense-in-depth security systems |
|
|
|
|
## Integrations
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Channel Adapters](channel-adapters.md) | 40 messaging channels -- setup, configuration, custom adapters |
|
|
| [LLM Providers](providers.md) | 20 providers, 51 models, 23 aliases -- setup and model routing |
|
|
| [Skills](skill-development.md) | 60 bundled skills, custom skill development, FangHub marketplace |
|
|
| [MCP & A2A](mcp-a2a.md) | Model Context Protocol and Agent-to-Agent protocol integration |
|
|
|
|
## Reference
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [API Reference](api-reference.md) | All 76 REST/WS/SSE endpoints with request/response examples |
|
|
| [Desktop App](desktop.md) | Tauri 2.0 native app -- build, features, architecture |
|
|
|
|
## Release & Operations
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Production Checklist](production-checklist.md) | Every step before tagging v0.1.0 -- signing keys, secrets, verification |
|
|
|
|
## Additional Resources
|
|
|
|
| Resource | Description |
|
|
|----------|-------------|
|
|
| [CONTRIBUTING.md](../CONTRIBUTING.md) | Development setup, code style, PR guidelines |
|
|
| [MIGRATION.md](../MIGRATION.md) | Migrating from OpenClaw, LangChain, or AutoGPT |
|
|
| [SECURITY.md](../SECURITY.md) | Security policy and vulnerability reporting |
|
|
| [CHANGELOG.md](../CHANGELOG.md) | Release notes and version history |
|
|
|
|
---
|
|
|
|
## Quick Reference
|
|
|
|
### Start in 30 Seconds
|
|
|
|
```bash
|
|
export GROQ_API_KEY="your-key"
|
|
openfang init && openfang start
|
|
# Open http://127.0.0.1:4200
|
|
```
|
|
|
|
### Key Numbers
|
|
|
|
| Metric | Count |
|
|
|--------|-------|
|
|
| Crates | 14 |
|
|
| Agent templates | 30 |
|
|
| Messaging channels | 40 |
|
|
| Bundled skills | 60 |
|
|
| Built-in tools | 38 |
|
|
| LLM providers | 20 |
|
|
| Models in catalog | 51 |
|
|
| Model aliases | 23 |
|
|
| API endpoints | 76 |
|
|
| Security systems | 16 |
|
|
| Tests | 967 |
|
|
|
|
### Important Paths
|
|
|
|
| Path | Description |
|
|
|------|-------------|
|
|
| `~/.openfang/config.toml` | Main configuration file |
|
|
| `~/.openfang/data/openfang.db` | SQLite database |
|
|
| `~/.openfang/skills/` | Installed skills |
|
|
| `~/.openfang/daemon.json` | Daemon PID and port info |
|
|
| `agents/` | Agent template manifests |
|
|
|
|
### Key Environment Variables
|
|
|
|
| Variable | Provider |
|
|
|----------|----------|
|
|
| `ANTHROPIC_API_KEY` | Anthropic (Claude) |
|
|
| `OPENAI_API_KEY` | OpenAI (GPT-4o) |
|
|
| `GEMINI_API_KEY` | Google Gemini |
|
|
| `GROQ_API_KEY` | Groq (fast Llama/Mixtral) |
|
|
| `DEEPSEEK_API_KEY` | DeepSeek |
|
|
| `XAI_API_KEY` | xAI (Grok) |
|
|
|
|
Only one provider key is needed to get started. Groq offers a free tier.
|