Metadata-Version: 2.4
Name: qualien-pulse-worker
Version: 0.1.0
Summary: Pulse — AI mobile-test worker for qualien.ai. Runs on the user's own machine (bring-your-own-compute), driving Android (Appium/UiAutomator2) and iOS (Appium/XCUITest) devices.
Author: qualien
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://qualien.ai
Project-URL: Documentation, https://qualien.ai/pulse/setup
Keywords: testing,mobile,android,ios,appium,xcuitest,qa,ai-agent,qualien,pulse
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic<3,>=2.5
Requires-Dist: Appium-Python-Client<5,>=4
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn>=0.27
Requires-Dist: python-multipart>=0.0.9
Provides-Extra: agent
Requires-Dist: claude-agent-sdk>=0.1; extra == "agent"
Dynamic: license-file

# qualien-pulse-worker

The local worker for **[Pulse](https://qualien.ai/agents/pulse)**, qualien's
autonomous mobile testing agent. Pulse runs on your own machine
(bring-your-own-compute): this worker drives an Android emulator or device
(Appium + UiAutomator2) or an iOS Simulator (Appium + XCUITest), runs the test
steps Pulse plans, captures a screenshot and video for every run, and reports
back to your qualien.ai dashboard.

**Full setup guide:** https://qualien.ai/pulse/setup

## Install

Requires Python 3.10+.

```bash
pipx install --python python3.12 "qualien-pulse-worker[agent]"
```

(`[agent]` adds the optional local agent mode. Without it:
`pipx install qualien-pulse-worker`.)

## Run

1. Sign in at [qualien.ai](https://qualien.ai), open **Pulse → Settings**, and
   generate a **worker token**.
2. Start an Android emulator (or connect a device) and Appium, then:

```bash
PULSE_WORKER_SECRET='<your worker token>' pulse-worker serve
```

The Pulse dashboard connects to the worker at `http://localhost:8787` — open it
in Chrome or Edge.

```bash
pulse-worker env       # check this machine has everything Pulse needs
pulse-worker devices   # list devices and emulators
```

## Licence

Proprietary — free to install and use with qualien.ai. See `LICENSE`.
Questions: contact@qualien.ai
