mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-23 20:23:00 +00:00
zeekay
5cedf194aa
- Updated dependency to hanzo-net>=0.1.11 for QR code alignment fixes - Includes proper network IP detection for mobile access - Fixed 'Chat API endpoint' label and display spacing
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