mirror of https://github.com/hanzoai/python-sdk.git synced 2026-10-23 20:23:00 +00:00

Files

T

zooqueenandHanzo Dev b144973bfc fix(lint): resolve all ruff + black errors across all packages

Fix 35 ruff errors (E722, F841, B904, B905, B007, E741, S202, S310,
S306, S110, TID251, UP042, F401) and run black on 526 files.

Co-authored-by: Hanzo Dev <[email protected]>

2026-02-21 23:32:32 -08:00

hanzo_tools

fix(lint): resolve all ruff + black errors across all packages

2026-02-21 23:32:32 -08:00

tests

style: format test files with black

2025-12-27 15:00:11 -08:00

pyproject.toml

chore: bump versions for consolidated computer/screen tools

2026-01-11 22:06:11 -08:00

README.md

feat(hanzo-tools): v0.10.17 - modular tool packages + computer control

2025-12-26 06:37:28 -08:00

uv.lock

chore: update sub-package dependencies for security fixes

2026-02-02 22:40:00 -08:00

README.md

hanzo-tools-computer

Computer control tools for Hanzo AI - pyautogui-based Mac automation.

Installation

pip install hanzo-tools-computer

Usage

from hanzo_tools.computer import ComputerTool, register_tools

# Register with MCP server
register_tools(mcp_server, permission_manager)

Actions

Mouse

click - Click at (x, y)
double_click - Double click at (x, y)
right_click - Right click at (x, y)
move - Move mouse to (x, y)
drag - Drag to (x, y)
scroll - Scroll by amount

Keyboard

type - Type text string
press - Press single key
hotkey - Press key combination

Screen

screenshot - Capture screen
locate - Find image on screen
info - Get screen/mouse info

Examples

# Click at coordinates
computer(action="click", x=100, y=200)

# Type text
computer(action="type", text="Hello world")

# Keyboard shortcut (Cmd+C on Mac)
computer(action="hotkey", keys=["command", "c"])

# Take screenshot
computer(action="screenshot")

# Get screen info
computer(action="info")

Safety

FAILSAFE enabled: Move mouse to corner to abort
macOS only (checks platform)
All actions run in executor threads (non-blocking)

License

MIT