Files
zeekay 7ff34ba5bf feat(hanzo-tools): v0.10.17 - modular tool packages + computer control
- Add hanzo-tools-computer package for pyautogui Mac automation
- Fix hanzo-tools-agent imports to use new package structure
- Add get_read_only_*_tools() helpers to filesystem/jupyter
- Remove BatchTool (replaced by dag - one tool per capability)
- Remove hanzo-persona dependency (not published yet)
- Simplify pyproject.toml for local development

Packages ready for PyPI:
- hanzo-tools-core
- hanzo-tools-filesystem
- hanzo-tools-shell
- hanzo-tools-browser
- hanzo-tools-memory
- hanzo-tools-todo
- hanzo-tools-reasoning
- hanzo-tools-lsp
- hanzo-tools-refactor
- hanzo-tools-database
- hanzo-tools-agent
- hanzo-tools-jupyter
- hanzo-tools-editor
- hanzo-tools-computer (NEW)
2025-12-26 06:37:28 -08:00

1.2 KiB

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