Initial commit — OpenFang Agent Operating System

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

sdk/python/examples/echo_agent.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Example OpenFang agent: echoes back messages with a friendly greeting."""
+
+import sys
+import os
+
+# Add parent directory to path for openfang_sdk import
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+from openfang_sdk import Agent
+
+agent = Agent()
+
+
+@agent.on_message
+def handle(message: str, context: dict) -> str:
+    agent_id = context.get("agent_id", os.environ.get("OPENFANG_AGENT_ID", "unknown"))
+    return f"Hello from Python agent {agent_id}! You said: {message}"
+
+
+agent.run()