tapherd 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- tapherd-0.1.0/LICENSE +21 -0
- tapherd-0.1.0/PKG-INFO +147 -0
- tapherd-0.1.0/README.md +114 -0
- tapherd-0.1.0/pyproject.toml +69 -0
- tapherd-0.1.0/setup.cfg +4 -0
- tapherd-0.1.0/site/assets/demo-poster.jpg +0 -0
- tapherd-0.1.0/site/assets/og-image.jpg +0 -0
- tapherd-0.1.0/site/assets/pixel-1.png +0 -0
- tapherd-0.1.0/site/assets/pixel-2.png +0 -0
- tapherd-0.1.0/site/index.html +492 -0
- tapherd-0.1.0/site/privacy.html +64 -0
- tapherd-0.1.0/src/tapherd/__init__.py +1 -0
- tapherd-0.1.0/src/tapherd/actions/__init__.py +1 -0
- tapherd-0.1.0/src/tapherd/actions/android.py +393 -0
- tapherd-0.1.0/src/tapherd/cli.py +491 -0
- tapherd-0.1.0/src/tapherd/config.py +62 -0
- tapherd-0.1.0/src/tapherd/devices/__init__.py +1 -0
- tapherd-0.1.0/src/tapherd/devices/action_log.py +74 -0
- tapherd-0.1.0/src/tapherd/devices/adb.py +229 -0
- tapherd-0.1.0/src/tapherd/devices/registry.py +292 -0
- tapherd-0.1.0/src/tapherd/devices/state.py +198 -0
- tapherd-0.1.0/src/tapherd/errors.py +5 -0
- tapherd-0.1.0/src/tapherd/mcp_config.py +99 -0
- tapherd-0.1.0/src/tapherd/mcp_server.py +317 -0
- tapherd-0.1.0/src/tapherd/recipes/__init__.py +1 -0
- tapherd-0.1.0/src/tapherd/recipes/bundled/youtube_shorts_post.yaml +140 -0
- tapherd-0.1.0/src/tapherd/recipes/catalog.py +65 -0
- tapherd-0.1.0/src/tapherd/recipes/runner.py +332 -0
- tapherd-0.1.0/src/tapherd/recipes/schema.py +275 -0
- tapherd-0.1.0/src/tapherd/tease.py +31 -0
- tapherd-0.1.0/src/tapherd/ui/__init__.py +1 -0
- tapherd-0.1.0/src/tapherd/ui/screen.py +108 -0
- tapherd-0.1.0/src/tapherd.egg-info/PKG-INFO +147 -0
- tapherd-0.1.0/src/tapherd.egg-info/SOURCES.txt +39 -0
- tapherd-0.1.0/src/tapherd.egg-info/dependency_links.txt +1 -0
- tapherd-0.1.0/src/tapherd.egg-info/entry_points.txt +2 -0
- tapherd-0.1.0/src/tapherd.egg-info/requires.txt +6 -0
- tapherd-0.1.0/src/tapherd.egg-info/top_level.txt +1 -0
- tapherd-0.1.0/tests/test_android.py +1308 -0
- tapherd-0.1.0/tests/test_cli.py +109 -0
- tapherd-0.1.0/tests/test_site.py +149 -0
tapherd-0.1.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 TapHerd contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
tapherd-0.1.0/PKG-INFO
ADDED
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: tapherd
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Your AI can now use Android apps: an MCP server and CLI that let Codex, Claude, or Cursor control your Android phones and emulators.
|
|
5
|
+
License-Expression: MIT
|
|
6
|
+
Project-URL: Homepage, https://github.com/GreenPeaas/tapherd
|
|
7
|
+
Project-URL: Documentation, https://github.com/GreenPeaas/tapherd#readme
|
|
8
|
+
Project-URL: Issues, https://github.com/GreenPeaas/tapherd/issues
|
|
9
|
+
Project-URL: Changelog, https://github.com/GreenPeaas/tapherd/blob/main/CHANGELOG.md
|
|
10
|
+
Keywords: mcp,android,adb,ai-agents,automation,codex,claude
|
|
11
|
+
Classifier: Development Status :: 3 - Alpha
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: MacOS
|
|
15
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
16
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
17
|
+
Classifier: Programming Language :: Python :: 3
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Topic :: Software Development :: Testing
|
|
22
|
+
Classifier: Topic :: Utilities
|
|
23
|
+
Requires-Python: >=3.11
|
|
24
|
+
Description-Content-Type: text/markdown
|
|
25
|
+
License-File: LICENSE
|
|
26
|
+
Requires-Dist: adbutils<3,>=2.12
|
|
27
|
+
Requires-Dist: mcp<2,>=1.30
|
|
28
|
+
Requires-Dist: pillow<14,>=11
|
|
29
|
+
Requires-Dist: pydantic<3,>=2.10
|
|
30
|
+
Requires-Dist: pyyaml<7,>=6.0.2
|
|
31
|
+
Requires-Dist: typer<1,>=0.16
|
|
32
|
+
Dynamic: license-file
|
|
33
|
+
|
|
34
|
+
# TapHerd
|
|
35
|
+
|
|
36
|
+
**Your AI can now use Android apps.**
|
|
37
|
+
|
|
38
|
+
TapHerd is a free, open-source connector that lets Codex, Claude, Cursor, or any MCP client control your Android phones and emulators. Your AI sees the screen, taps, types, opens apps, and copies media, on up to three devices for free.
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
# macOS and Linux
|
|
42
|
+
curl -LsSf https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.sh | sh
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
```powershell
|
|
46
|
+
# Windows (PowerShell, no administrator rights needed)
|
|
47
|
+
irm https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.ps1 | iex
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
The installers set up uv and TapHerd for your user, offer to install Android's `adb` tool, and run `tapherd doctor`. They explain and ask before anything that needs `sudo`. [What the installer does](scripts/install.sh)
|
|
51
|
+
|
|
52
|
+
**macOS: tested · Windows and Linux: beta**
|
|
53
|
+
|
|
54
|
+
> **Who it's for:** developers and technical creators. You need a computer plus an Android emulator or an Android phone.
|
|
55
|
+
|
|
56
|
+
<img src="docs/launch/tapherd-demo.gif" width="720" alt="Animated replay: one open_app_many call opens Android Settings on Pixel 1 and Pixel 2, and each Pixel reports ok: true">
|
|
57
|
+
|
|
58
|
+
Animated replay of a verified run: one TapHerd call opened Settings on two Pixel emulators. [Watch one prompt post to three platforms](https://www.loom.com/share/70ccf876444b4c699cadd68c9a193c85) (real screen recording, sped up, names blurred)
|
|
59
|
+
|
|
60
|
+
## What it's for
|
|
61
|
+
|
|
62
|
+
- **Posting.** Ask your AI to post a video to TikTok, Instagram Reels, and YouTube Shorts from your phones, with captions it writes. One prompt did this on 2026-11-19, on one emulator: Shorts set to Private, TikTok to Only you, and Reels public. The same tools work in other Android apps, such as X and the main YouTube app.
|
|
63
|
+
- **QA testing.** Let an agent walk through your Android app on several emulators at once.
|
|
64
|
+
- **Store screenshots.** Capture the same screens on several devices.
|
|
65
|
+
- **Mobile-only apps.** Use apps that have no web or API version.
|
|
66
|
+
- **Your own analytics.** Read numbers from your own accounts' in-app dashboards.
|
|
67
|
+
|
|
68
|
+
TapHerd only acts on devices you connect, through apps you're signed into. Its recipes and scheduler only support posting to accounts you own. [Acceptable use](docs/ACCEPTABLE_USE.md)
|
|
69
|
+
|
|
70
|
+
## Install → first AI-controlled tap (about 5 minutes)
|
|
71
|
+
|
|
72
|
+
1. **Get an Android device.** Start a free Pixel emulator from Android Studio, or connect a phone with USB debugging on. [macOS](docs/SETUP_MAC.md#download-the-android-emulator) · [Windows](docs/SETUP_WINDOWS.md) · [Linux](docs/SETUP_LINUX.md)
|
|
73
|
+
2. **Install TapHerd** with the one-liner above, or manually with [uv](https://docs.astral.sh/uv/getting-started/installation/):
|
|
74
|
+
|
|
75
|
+
```sh
|
|
76
|
+
uv tool install git+https://github.com/GreenPeaas/tapherd
|
|
77
|
+
tapherd doctor
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
3. **Connect your AI client.** Print its config and paste it where TapHerd says. [Exact steps for each client](docs/CONNECT_YOUR_AI.md)
|
|
81
|
+
|
|
82
|
+
```sh
|
|
83
|
+
tapherd config mcp --client claude-code # or codex, claude-desktop, cursor
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
4. **Ask it to do something:**
|
|
87
|
+
|
|
88
|
+
> Use TapHerd to list my devices. On the first one, open Settings, read the screen, tap **Network & internet**, and tell me what opened.
|
|
89
|
+
|
|
90
|
+
You should see **Network & internet** open on the device.
|
|
91
|
+
|
|
92
|
+
### Try it from the command line with Claude Code
|
|
93
|
+
|
|
94
|
+
This runs the same check with a temporary MCP config and only the four tools it needs:
|
|
95
|
+
|
|
96
|
+
```sh
|
|
97
|
+
TAPHERD_FIRST_TAP_DIR=$(mktemp -d)
|
|
98
|
+
tapherd config mcp --client claude-code > "$TAPHERD_FIRST_TAP_DIR/mcp.json"
|
|
99
|
+
(
|
|
100
|
+
cd "$TAPHERD_FIRST_TAP_DIR" || exit
|
|
101
|
+
claude --print \
|
|
102
|
+
'Use only TapHerd MCP. List devices. On the first active device, open com.android.settings, use read_screen to find Network & internet, tap that row, and tell me what opened.' \
|
|
103
|
+
--mcp-config "$TAPHERD_FIRST_TAP_DIR/mcp.json" --strict-mcp-config \
|
|
104
|
+
--no-session-persistence --tools '' \
|
|
105
|
+
--allowedTools mcp__tapherd__list_devices mcp__tapherd__open_app \
|
|
106
|
+
mcp__tapherd__read_screen mcp__tapherd__tap
|
|
107
|
+
)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Menu labels can vary by Android version or language. If Settings resumes on a subpage, go back to its home screen and try again.
|
|
111
|
+
|
|
112
|
+
## Not a developer? The fastest path
|
|
113
|
+
|
|
114
|
+
1. Run the one-line installer above. It sets everything up and runs `tapherd doctor`.
|
|
115
|
+
2. For a phone, either install Android Studio and start an emulator (the setup guide walks through it), or use a cloud phone that offers ADB access and connect it with `tapherd connect <host:port>`. Cloud phones haven't been tested with TapHerd yet, so provider guides are coming.
|
|
116
|
+
3. Install Claude Desktop, run `tapherd config mcp --client claude-desktop`, and paste the result where it says.
|
|
117
|
+
4. Ask Claude to do something on the phone.
|
|
118
|
+
|
|
119
|
+
## Free and Pro
|
|
120
|
+
|
|
121
|
+
| | Free (this repo, MIT) | Pro (coming soon) |
|
|
122
|
+
| --- | --- | --- |
|
|
123
|
+
| Active devices | Up to 3 | 50+ target |
|
|
124
|
+
| AI control of any Android app | ✓ | ✓ |
|
|
125
|
+
| Posting recipes | 1 unverified YouTube Shorts sample | Maintained recipe library |
|
|
126
|
+
| Scheduling | Run on demand | Scheduled posting |
|
|
127
|
+
| Dashboard | — | Planned |
|
|
128
|
+
|
|
129
|
+
`tapherd pro` opens the waitlist. The CLI shows a Pro notice at most once a day; set `TAPHERD_NO_TEASE=1` to turn it off.
|
|
130
|
+
|
|
131
|
+
## Docs
|
|
132
|
+
|
|
133
|
+
| Get started | Use it | Project |
|
|
134
|
+
| --- | --- | --- |
|
|
135
|
+
| [Setup on macOS](docs/SETUP_MAC.md) | [MCP tools](docs/TOOLS.md) | [Security and data flow](docs/SECURITY.md) |
|
|
136
|
+
| [Setup on Windows (beta)](docs/SETUP_WINDOWS.md) | [Recipes](docs/RECIPES.md) | [Acceptable use](docs/ACCEPTABLE_USE.md) |
|
|
137
|
+
| [Setup on Linux (beta)](docs/SETUP_LINUX.md) | [Advanced MCP options](docs/MCP.md) | [Contributing](CONTRIBUTING.md) |
|
|
138
|
+
| [Connect your AI](docs/CONNECT_YOUR_AI.md) | [Architecture](docs/ARCHITECTURE.md) | [Changelog](CHANGELOG.md) |
|
|
139
|
+
| [Troubleshooting](docs/TROUBLESHOOTING.md) | [Demo clips](demo/README.md) | [License (MIT)](LICENSE) |
|
|
140
|
+
|
|
141
|
+
## Privacy
|
|
142
|
+
|
|
143
|
+
The free connector runs entirely on your computer and has no telemetry. Screenshots and the optional action log stay local. TapHerd never asks for or stores passwords. You sign in to apps on the device yourself. [Security and data flow](docs/SECURITY.md)
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
TapHerd is not affiliated with or endorsed by TikTok, Meta, Google, or X. All trademarks belong to their owners.
|
tapherd-0.1.0/README.md
ADDED
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# TapHerd
|
|
2
|
+
|
|
3
|
+
**Your AI can now use Android apps.**
|
|
4
|
+
|
|
5
|
+
TapHerd is a free, open-source connector that lets Codex, Claude, Cursor, or any MCP client control your Android phones and emulators. Your AI sees the screen, taps, types, opens apps, and copies media, on up to three devices for free.
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
# macOS and Linux
|
|
9
|
+
curl -LsSf https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.sh | sh
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
```powershell
|
|
13
|
+
# Windows (PowerShell, no administrator rights needed)
|
|
14
|
+
irm https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.ps1 | iex
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
The installers set up uv and TapHerd for your user, offer to install Android's `adb` tool, and run `tapherd doctor`. They explain and ask before anything that needs `sudo`. [What the installer does](scripts/install.sh)
|
|
18
|
+
|
|
19
|
+
**macOS: tested · Windows and Linux: beta**
|
|
20
|
+
|
|
21
|
+
> **Who it's for:** developers and technical creators. You need a computer plus an Android emulator or an Android phone.
|
|
22
|
+
|
|
23
|
+
<img src="docs/launch/tapherd-demo.gif" width="720" alt="Animated replay: one open_app_many call opens Android Settings on Pixel 1 and Pixel 2, and each Pixel reports ok: true">
|
|
24
|
+
|
|
25
|
+
Animated replay of a verified run: one TapHerd call opened Settings on two Pixel emulators. [Watch one prompt post to three platforms](https://www.loom.com/share/70ccf876444b4c699cadd68c9a193c85) (real screen recording, sped up, names blurred)
|
|
26
|
+
|
|
27
|
+
## What it's for
|
|
28
|
+
|
|
29
|
+
- **Posting.** Ask your AI to post a video to TikTok, Instagram Reels, and YouTube Shorts from your phones, with captions it writes. One prompt did this on 2026-11-19, on one emulator: Shorts set to Private, TikTok to Only you, and Reels public. The same tools work in other Android apps, such as X and the main YouTube app.
|
|
30
|
+
- **QA testing.** Let an agent walk through your Android app on several emulators at once.
|
|
31
|
+
- **Store screenshots.** Capture the same screens on several devices.
|
|
32
|
+
- **Mobile-only apps.** Use apps that have no web or API version.
|
|
33
|
+
- **Your own analytics.** Read numbers from your own accounts' in-app dashboards.
|
|
34
|
+
|
|
35
|
+
TapHerd only acts on devices you connect, through apps you're signed into. Its recipes and scheduler only support posting to accounts you own. [Acceptable use](docs/ACCEPTABLE_USE.md)
|
|
36
|
+
|
|
37
|
+
## Install → first AI-controlled tap (about 5 minutes)
|
|
38
|
+
|
|
39
|
+
1. **Get an Android device.** Start a free Pixel emulator from Android Studio, or connect a phone with USB debugging on. [macOS](docs/SETUP_MAC.md#download-the-android-emulator) · [Windows](docs/SETUP_WINDOWS.md) · [Linux](docs/SETUP_LINUX.md)
|
|
40
|
+
2. **Install TapHerd** with the one-liner above, or manually with [uv](https://docs.astral.sh/uv/getting-started/installation/):
|
|
41
|
+
|
|
42
|
+
```sh
|
|
43
|
+
uv tool install git+https://github.com/GreenPeaas/tapherd
|
|
44
|
+
tapherd doctor
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
3. **Connect your AI client.** Print its config and paste it where TapHerd says. [Exact steps for each client](docs/CONNECT_YOUR_AI.md)
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
tapherd config mcp --client claude-code # or codex, claude-desktop, cursor
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
4. **Ask it to do something:**
|
|
54
|
+
|
|
55
|
+
> Use TapHerd to list my devices. On the first one, open Settings, read the screen, tap **Network & internet**, and tell me what opened.
|
|
56
|
+
|
|
57
|
+
You should see **Network & internet** open on the device.
|
|
58
|
+
|
|
59
|
+
### Try it from the command line with Claude Code
|
|
60
|
+
|
|
61
|
+
This runs the same check with a temporary MCP config and only the four tools it needs:
|
|
62
|
+
|
|
63
|
+
```sh
|
|
64
|
+
TAPHERD_FIRST_TAP_DIR=$(mktemp -d)
|
|
65
|
+
tapherd config mcp --client claude-code > "$TAPHERD_FIRST_TAP_DIR/mcp.json"
|
|
66
|
+
(
|
|
67
|
+
cd "$TAPHERD_FIRST_TAP_DIR" || exit
|
|
68
|
+
claude --print \
|
|
69
|
+
'Use only TapHerd MCP. List devices. On the first active device, open com.android.settings, use read_screen to find Network & internet, tap that row, and tell me what opened.' \
|
|
70
|
+
--mcp-config "$TAPHERD_FIRST_TAP_DIR/mcp.json" --strict-mcp-config \
|
|
71
|
+
--no-session-persistence --tools '' \
|
|
72
|
+
--allowedTools mcp__tapherd__list_devices mcp__tapherd__open_app \
|
|
73
|
+
mcp__tapherd__read_screen mcp__tapherd__tap
|
|
74
|
+
)
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Menu labels can vary by Android version or language. If Settings resumes on a subpage, go back to its home screen and try again.
|
|
78
|
+
|
|
79
|
+
## Not a developer? The fastest path
|
|
80
|
+
|
|
81
|
+
1. Run the one-line installer above. It sets everything up and runs `tapherd doctor`.
|
|
82
|
+
2. For a phone, either install Android Studio and start an emulator (the setup guide walks through it), or use a cloud phone that offers ADB access and connect it with `tapherd connect <host:port>`. Cloud phones haven't been tested with TapHerd yet, so provider guides are coming.
|
|
83
|
+
3. Install Claude Desktop, run `tapherd config mcp --client claude-desktop`, and paste the result where it says.
|
|
84
|
+
4. Ask Claude to do something on the phone.
|
|
85
|
+
|
|
86
|
+
## Free and Pro
|
|
87
|
+
|
|
88
|
+
| | Free (this repo, MIT) | Pro (coming soon) |
|
|
89
|
+
| --- | --- | --- |
|
|
90
|
+
| Active devices | Up to 3 | 50+ target |
|
|
91
|
+
| AI control of any Android app | ✓ | ✓ |
|
|
92
|
+
| Posting recipes | 1 unverified YouTube Shorts sample | Maintained recipe library |
|
|
93
|
+
| Scheduling | Run on demand | Scheduled posting |
|
|
94
|
+
| Dashboard | — | Planned |
|
|
95
|
+
|
|
96
|
+
`tapherd pro` opens the waitlist. The CLI shows a Pro notice at most once a day; set `TAPHERD_NO_TEASE=1` to turn it off.
|
|
97
|
+
|
|
98
|
+
## Docs
|
|
99
|
+
|
|
100
|
+
| Get started | Use it | Project |
|
|
101
|
+
| --- | --- | --- |
|
|
102
|
+
| [Setup on macOS](docs/SETUP_MAC.md) | [MCP tools](docs/TOOLS.md) | [Security and data flow](docs/SECURITY.md) |
|
|
103
|
+
| [Setup on Windows (beta)](docs/SETUP_WINDOWS.md) | [Recipes](docs/RECIPES.md) | [Acceptable use](docs/ACCEPTABLE_USE.md) |
|
|
104
|
+
| [Setup on Linux (beta)](docs/SETUP_LINUX.md) | [Advanced MCP options](docs/MCP.md) | [Contributing](CONTRIBUTING.md) |
|
|
105
|
+
| [Connect your AI](docs/CONNECT_YOUR_AI.md) | [Architecture](docs/ARCHITECTURE.md) | [Changelog](CHANGELOG.md) |
|
|
106
|
+
| [Troubleshooting](docs/TROUBLESHOOTING.md) | [Demo clips](demo/README.md) | [License (MIT)](LICENSE) |
|
|
107
|
+
|
|
108
|
+
## Privacy
|
|
109
|
+
|
|
110
|
+
The free connector runs entirely on your computer and has no telemetry. Screenshots and the optional action log stay local. TapHerd never asks for or stores passwords. You sign in to apps on the device yourself. [Security and data flow](docs/SECURITY.md)
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
TapHerd is not affiliated with or endorsed by TikTok, Meta, Google, or X. All trademarks belong to their owners.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=77"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "tapherd"
|
|
7
|
+
version = "0.1.0"
|
|
8
|
+
description = "Your AI can now use Android apps: an MCP server and CLI that let Codex, Claude, or Cursor control your Android phones and emulators."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.11"
|
|
11
|
+
license = "MIT"
|
|
12
|
+
license-files = ["LICENSE"]
|
|
13
|
+
keywords = ["mcp", "android", "adb", "ai-agents", "automation", "codex", "claude"]
|
|
14
|
+
classifiers = [
|
|
15
|
+
"Development Status :: 3 - Alpha",
|
|
16
|
+
"Environment :: Console",
|
|
17
|
+
"Intended Audience :: Developers",
|
|
18
|
+
"Operating System :: MacOS",
|
|
19
|
+
"Operating System :: Microsoft :: Windows",
|
|
20
|
+
"Operating System :: POSIX :: Linux",
|
|
21
|
+
"Programming Language :: Python :: 3",
|
|
22
|
+
"Programming Language :: Python :: 3.11",
|
|
23
|
+
"Programming Language :: Python :: 3.12",
|
|
24
|
+
"Programming Language :: Python :: 3.13",
|
|
25
|
+
"Topic :: Software Development :: Testing",
|
|
26
|
+
"Topic :: Utilities",
|
|
27
|
+
]
|
|
28
|
+
dependencies = [
|
|
29
|
+
"adbutils>=2.12,<3",
|
|
30
|
+
"mcp>=1.30,<2",
|
|
31
|
+
"pillow>=11,<14",
|
|
32
|
+
"pydantic>=2.10,<3",
|
|
33
|
+
"pyyaml>=6.0.2,<7",
|
|
34
|
+
"typer>=0.16,<1",
|
|
35
|
+
]
|
|
36
|
+
|
|
37
|
+
[project.urls]
|
|
38
|
+
Homepage = "https://github.com/GreenPeaas/tapherd"
|
|
39
|
+
Documentation = "https://github.com/GreenPeaas/tapherd#readme"
|
|
40
|
+
Issues = "https://github.com/GreenPeaas/tapherd/issues"
|
|
41
|
+
Changelog = "https://github.com/GreenPeaas/tapherd/blob/main/CHANGELOG.md"
|
|
42
|
+
|
|
43
|
+
[project.scripts]
|
|
44
|
+
tapherd = "tapherd.cli:app"
|
|
45
|
+
|
|
46
|
+
[tool.setuptools.package-data]
|
|
47
|
+
"tapherd.recipes" = ["bundled/*.yaml"]
|
|
48
|
+
|
|
49
|
+
[tool.setuptools.data-files]
|
|
50
|
+
"share/tapherd/site" = ["site/index.html", "site/privacy.html"]
|
|
51
|
+
"share/tapherd/site/assets" = [
|
|
52
|
+
"site/assets/demo-poster.jpg",
|
|
53
|
+
"site/assets/og-image.jpg",
|
|
54
|
+
]
|
|
55
|
+
|
|
56
|
+
[dependency-groups]
|
|
57
|
+
dev = [
|
|
58
|
+
"pytest>=8.3",
|
|
59
|
+
"ruff>=0.11",
|
|
60
|
+
]
|
|
61
|
+
|
|
62
|
+
[tool.ruff]
|
|
63
|
+
target-version = "py311"
|
|
64
|
+
|
|
65
|
+
[tool.ruff.lint]
|
|
66
|
+
extend-select = ["I", "UP"]
|
|
67
|
+
|
|
68
|
+
[tool.pytest.ini_options]
|
|
69
|
+
testpaths = ["tests"]
|
tapherd-0.1.0/setup.cfg
ADDED
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|