mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-26 11:49:36 +00:00
zeekay
c208583d94
- Integrate hanzo-network for advanced agent orchestration - Support configurable orchestrator models (GPT-5, GPT-4, Claude, local models) - Add hanzo/net support for local AI via --orchestrator local:model syntax - Implement cost-optimized routing that prefers local models for simple tasks - Create MCP bridge for inter-Claude communication - Add NetworkOrchestrator class using hanzo-network infrastructure - Support hybrid networks with local + API agents for 90% cost reduction - Add automatic hanzo net startup when using local models - Implement System 2 thinking with primary + critic agents - Enable recursive agent calling through MCP networking The system now supports: - Local AI orchestration via hanzo net (Llama 3.2, etc.) - Cost-effective routing (local for simple, API for complex) - Multi-tier architecture (orchestration, implementation, QA) - Automatic fallback from local to API when needed - Full MCP tool support across all agents
Hanzo AI - Complete AI Infrastructure Platform
The main SDK for the Hanzo AI ecosystem, providing unified access to all Hanzo tools and services.
Installation
# Install base package with CLI
pip install hanzo
# Install with all components
pip install hanzo[all]
# Install specific components
pip install hanzo[ai] # AI SDK (same as standalone hanzoai package)
pip install hanzo[router] # LLM gateway router (replaces litellm)
pip install hanzo[mcp] # Model Context Protocol server
pip install hanzo[agents] # Agent runtime and orchestration
pip install hanzo[repl] # Interactive REPL with AI chat
Features
- Unified LLM Gateway: Use
hanzo.routerinstead of litellm for 100+ LLM providers - MCP Integration: Full Model Context Protocol support for AI tools
- Agent Runtime: Build and deploy AI agents with the agent framework
- Interactive REPL: Chat with AI models directly from the command line
- Complete SDK: Import all Hanzo components from a single package
Quick Start
Command Line
# Main CLI
hanzo --help
# Start MCP server
hanzo-mcp
# Interactive AI chat
hanzo-ai
hanzo-chat
# REPL interface
hanzo-repl
Python SDK
import hanzo
# Use router for LLM calls (replaces litellm)
from hanzo import router
response = router.completion(
model="gpt-4",
messages=[{"role": "user", "content": "Hello!"}]
)
# Use agents
from hanzo import Agent, Network
agent = Agent(name="assistant")
# Use MCP tools
from hanzo import Tool, MCPServer
# Access AI SDK
from hanzo import Client
client = Client(api_key="...")
Components
- hanzo.router: Unified LLM gateway (replaces litellm)
- hanzo.mcp: Model Context Protocol server and tools
- hanzo.agents: Agent runtime and orchestration
- hanzo.memory: Memory systems for agents
- hanzo.Client: Main AI SDK client