Metadata-Version: 2.4
Name: eyehands-sdk
Version: 1.7.0
Summary: Python SDK for eyehands desktop automation — HTTP client, MCP server, OpenAI function calling.
Author-email: Fireal <fireal6353@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://portal.fireal.dev/eyehands/
Project-URL: Repository, https://github.com/shameindemgg/eyehands
Project-URL: Issues, https://github.com/shameindemgg/eyehands/issues
Keywords: eyehands,desktop-automation,mcp,ai-agent,sdk,claude,openai,function-calling
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"

# eyehands SDK

Python client for [eyehands](https://portal.fireal.dev/eyehands/) desktop automation.

eyehands runs as a standalone .exe on Windows, exposing screen capture, mouse/keyboard input, OCR, and UI Automation over HTTP on port 7331. This SDK wraps those HTTP calls so you can drive it from Python.

```python
from eyehands import EyehandsClient

client = EyehandsClient()  # auto-discovers auth token
client.click_at(500, 300)
screenshot = client.screenshot()  # returns JPEG bytes
matches = client.find("Submit")   # OCR text search
```

## Install

```
pip install eyehands-sdk
```

For the MCP server (Claude Desktop / Claude Code):

```
pip install eyehands-sdk[mcp]
eyehands-mcp
```

## The eyehands server

This package is just the client SDK. You need the eyehands server running on the target Windows machine. Download it from [portal.fireal.dev](https://portal.fireal.dev) or [GitHub Releases](https://github.com/shameindemgg/eyehands/releases).
