4.3 KiB
4.3 KiB
Hanzo Python SDK
The complete Python SDK for building AI applications with Hanzo AI infrastructure.
Overview
The Hanzo Python SDK provides:
- Agent SDK (
hanzo-agent) - Build agentic AI applications with a lightweight, production-ready framework - MCP Server (
hanzo-mcp) - Model Context Protocol server with 30+ tools for AI code assistants - Tool Packages (
hanzo-tools-*) - Modular tool packages for file operations, shell commands, browser automation, and more
Installation
=== "Full Install"
bash pip install hanzo-mcp[tools-all]
=== "Agent SDK Only"
bash pip install hanzo-agent
=== "Using uv"
bash uv pip install hanzo-mcp
Quick Start
Using with Claude Code
The easiest way to use Hanzo MCP is with Claude Code:
# Install globally
uvx hanzo-mcp
# Or run directly
uvx hanzo-mcp --transport stdio
Agent SDK Example
from agents import Agent, Runner
agent = Agent(
name="assistant",
instructions="You are a helpful assistant."
)
result = Runner.run_sync(agent, "Hello!")
print(result.final_output)
MCP Tools Example
from hanzo_mcp import create_mcp_server
# Create server with all tools
server = create_mcp_server()
server.run()
Packages
| Package | Description | PyPI |
|---|---|---|
hanzo-mcp |
MCP server with all tools |  |
hanzo-agent |
Agent SDK |  |
hanzo-tools-shell |
Shell/command tools |  |
hanzo-tools-fs |
File system tools |  |
hanzo-tools-browser |
Browser automation |  |
hanzo-tools-memory |
Memory/knowledge tools |  |
Features
30+ MCP Tools
- File System:
read,write,edit,tree,find,search,ast - Shell:
cmd,zsh,bash,ps,npx,uvx,open - Browser: Full Playwright automation with 70+ actions
- Memory: Unified memory tool with recall, create, update, delete
- Reasoning:
think,criticfor structured AI reasoning - LSP: Go-to-definition, find references, rename, hover
- Refactor: Advanced code refactoring with AST support
- Agent: Run external AI agents (Claude, Gemini, Codex, etc.)
- LLM: Direct LLM access and multi-model consensus
Auto-Backgrounding
Long-running commands automatically background after 30 seconds:
# This will auto-background if it takes too long
cmd("npm install")
# Check status
ps() # List all background processes
ps(logs="cmd_xxx") # View output
ps(kill="cmd_xxx") # Stop process
Multi-Backend Support
Use the MCP with any AI assistant:
- Claude Code -
uvx hanzo-mcp - VS Code/Cursor - Hanzo extension with auto-detection
- Antigravity - Full integration via Open VSX
- Any MCP Client - Standard MCP protocol
Documentation
Getting Started
Reference
- Tools Reference - All 30+ tool packages
- Agent Reference - Agent SDK documentation
- MCP Reference - MCP server documentation
- Core Libraries - Supporting packages (async, consensus, network)
Tool Categories
- Filesystem Tools - File operations and AST analysis
- Shell Tools - Command execution and process management
- Browser Tool - Playwright automation
- Memory Tools - Persistent memory and knowledge bases
- Reasoning Tools - Structured thinking and analysis