Metadata-Version: 2.4
Name: physiclaw
Version: 0.1.13
Summary: Give AI agents a physical finger to operate any phone — robotic stylus + camera, no APIs needed.
Project-URL: Homepage, https://github.com/physiclaw/PhysiClaw
Project-URL: Repository, https://github.com/physiclaw/PhysiClaw
Project-URL: Issues, https://github.com/physiclaw/PhysiClaw/issues
Author-email: Qiao Qian <qiaoqianda@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: grbl,llm-agent,mcp,phone-automation,robotics,stylus,vision
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Hardware
Requires-Python: >=3.12
Requires-Dist: anthropic>=0.40
Requires-Dist: croniter>=6.2.2
Requires-Dist: mcp[cli]>=1.2
Requires-Dist: numpy>=1.26
Requires-Dist: onnxruntime>=1.24.0
Requires-Dist: opencv-python>=4.8
Requires-Dist: pyserial>=3.5
Requires-Dist: rapidocr>=3.7.0
Requires-Dist: tomlkit>=0.13
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# PhysiClaw

**An AI agent that physically operates a phone — the way you do.**

[English docs](https://docs.physiclaw.ai/en/) · [中文文档](https://docs.physiclaw.ai/zh/)

PhysiClaw watches a phone's screen with a camera and taps it with a stylus,
working the phone the way a person would. No APIs, no OAuth, no ADB cables,
nothing installed on the phone — just unlock it, set it on the desk, and let
the agent work.

It's built for the everyday errands that pile up — ordering takeout, shopping
for groceries, booking a ride, paying a bill, replying to a message. Anything
you can do by hand on your phone, PhysiClaw can do for you.

## Why a physical body?

The apps that run your daily life are closed off: most expose no public API,
and simulated input — desktop automation or Android's ADB — leaves software
fingerprints that anti-bot systems flag. So PhysiClaw treats the screen itself
as the API: a camera reads it, a stylus performs the gestures. To the phone
it's indistinguishable from a real finger — nothing to detect — and it reaches
virtually any app reliably.

The trade-off is speed: a few seconds per action, in exchange for universality
and reliability.

## How it works

PhysiClaw has its own dedicated phone running its own WhatsApp account.
Add it as a contact and chat with it like a real person — tell it what you need
in plain language:

```text
Order a latte on DoorDash.
What's the weather tomorrow?
Buy milk and eggs on Instacart.
```

Its runtime loops continuously, waking the agent when a scheduled task is due
or the screen lights up with a new message. The agent unlocks the phone, reads
your message, and does the task — pausing for confirmation when it matters,
like a payment — then replies with the result, saves its memory, and exits
until it's next woken.

## Getting started

You'll need the PhysiClaw hardware — the arm, stylus, and camera — plus an
**iPhone** for it to operate.

The `physiclaw` CLI runs on macOS, Windows, and Linux:

```bash
# Install the CLI (uv + Python 3.12 + physiclaw)
curl -fsSL https://physiclaw.ai/install.sh | bash
# Windows: iwr -useb https://physiclaw.ai/install.ps1 | iex

physiclaw doctor    # check your environment
physiclaw           # start the server — opens the hardware-setup wizard, then runs the agent
```

## License

[MIT](LICENSE) — both the CAD-as-code hardware and the agent software.
