The Open-Source Mobile Native AGI. Appium Replacement and Termux Automator.
Project description
📱 OpenDroid Framework
The Most Advanced, Autonomous, Single-Click Mobile Agent on Earth.
Move over Desktop Agents. The Future of AI is Mobile.
Global PyPI Installation • Claude Code & Cursor • Enterprise QA • Why vs OpenClaw?
🛑 Important Notification for AI Operators
Important: Zero Desktop Hardware Required Frameworks like OpenClaw require you to purchase a Mac Mini to act as the Gateway. OpenDroid is explicitly engineered to compile and run natively inside an old Android phone via Termux. The phone acts as both the AI Brain and the Physical Hands.
Security Warning: Financial Asset Intercept You must adhere to the
TERMS_AND_POLICIES.md. OpenDroid is equipped with Hardcoded Financial Intercepts (guardrails.py). If the LLM accesses a banking app, OpenDroid will trigger a FATAL SECURITY INTERCEPT.
⚡ Quick Start: Global Installation
OpenDroid is officially released as a global Python package! You can deploy it anywhere using standard pip logic without ever cloning the repository.
Install the framework globally:
pip install opendroid-agi
Launch the Cyberpunk Terminal Interface:
opendroid
This command executes the interactive cli.py system, allowing you to instantly boot the 3D Dashboards, Background WhatsApp readers, or the DroidBuddy Tamagotchi right from your command line.
Method 2: The Native Android Pocket Server (Termux)
You want to run the whole server on an old Android phone you throw in your backpack?
- 📥 Download Termux and Termux:API from F-Droid.
- Paste this single command to bootstrap the universe:
curl -sL https://raw.githubusercontent.com/py811332-a11y/OpenDroid/main/install_termux.sh | bash
🤖 Real-World Command Examples
What can OpenDroid actually do? It executes human-level logic using MultiModal Vision bounding boxes.
"Check my emails, summarize unread ones, and text the summary to David on WhatsApp.""Open Uber, Ola, and Rapido. Find the cheapest fare to the Airport right now, and order it.""Open Instagram, find the latest post from @Nike, and double tap to like."
🔌 The MCP Server (Connect Claude Code & Cursor)
OpenDroid isn't just an isolated agent; it exposes a standardized Model Context Protocol (MCP) instance running on localhost:8000.
This means Desktop AI systems can now touch the physical world. If you use tools like Anthropic's Claude Code terminal, Cursor IDE, or OpenAI Codex, you can write a system prompt that says:
- "Run the test suite. If the server crashes, use the OpenDroid MCP to physically text my smartphone and wake me up."
🏢 Enterprise-Scale Use Cases
Why should multinational corporations deploy OpenDroid fleets instead of relying on standard test automation frameworks?
1. The Autonomous App Vulnerability Fuzzer (SecOps)
OpenDroid contains vulnerability_finder.py. You point OpenDroid at your proprietary Android App. It uses Vision AI to dynamically locate every text field. It aggressively injects malicious payloads (Cross-Site Scripting, Buffer Overflows, SQL Injections) attempting to crash the logic. It is an autonomous Android penetration-testing unit.
2. Physical Competitor Analysis & Scraping
Your enterprise can set up a "Device Farm" of 50 Android phones running OpenDroid telemetry.py arrays. You can autonomously open native competitor apps (Airbnb or Uber)—which block standard web scrapers like Puppeteer—read pricing, and dump the competitive intelligence directly to Datadog.
3. Native Shopify & WordPress Administration
Run shopify_bridge.py. OpenDroid will physically open your Android Shopify application, use Vision AI to select "Unfulfilled Orders," and process logistics manually without you ever having to configure broken REST/GraphQL webhooks.
👑 OpenDroid vs. OpenClaw
| Metric | OpenClaw | OpenDroid |
|---|---|---|
| Bot Detection Override | Fails. Cloudflare instantly detects Puppeteer instances. | Perfect. OS-level adb input tap on native Android apps. Undetectable. |
| Hardware Required | Minimum $500 Desktop/Mac. | $0. An old cracked Android phone from 2018. |
| Communications Layer | $100/mo Twilio API required. | $0 Native. whatsapp_bridge.py naturally intercepts Android push notifications. |
| Tamagotchi AI Empathy | Non-Existent. | Full SQLite DroidBuddy memory mapping tracks Happiness and physically jiggles your Android OS grid if it gets lonely. |
Built by the Open-Source Community. The 10,000 Star Standard.
Welcome to the Autonomous AGI Era.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file opendroid_agi-1.0.7.tar.gz.
File metadata
- Download URL: opendroid_agi-1.0.7.tar.gz
- Upload date:
- Size: 17.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0f9ba23628e8776aab41f2a287d7eee5515414f43b2ac0b26cf41608866acdf9
|
|
| MD5 |
a02ad9c8ffd35081fbf85b96c2f1079e
|
|
| BLAKE2b-256 |
3660f0be89504315b254d9c840fe51efb44eef55c78536973ae9d7d078c098a7
|
Provenance
The following attestation bundles were made for opendroid_agi-1.0.7.tar.gz:
Publisher:
workflow.yml on py811332-a11y/OpenDroid
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
opendroid_agi-1.0.7.tar.gz -
Subject digest:
0f9ba23628e8776aab41f2a287d7eee5515414f43b2ac0b26cf41608866acdf9 - Sigstore transparency entry: 1276919914
- Sigstore integration time:
-
Permalink:
py811332-a11y/OpenDroid@04e17ea72eb5258246b77e4c72047d9e568d6c8f -
Branch / Tag:
refs/tags/v1.0.7 - Owner: https://github.com/py811332-a11y
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@04e17ea72eb5258246b77e4c72047d9e568d6c8f -
Trigger Event:
push
-
Statement type:
File details
Details for the file opendroid_agi-1.0.7-py3-none-any.whl.
File metadata
- Download URL: opendroid_agi-1.0.7-py3-none-any.whl
- Upload date:
- Size: 17.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af0b44b5dc012474ad88e87e8cd6c859c36e0aa9af8f9f589fdea889fb94b9a7
|
|
| MD5 |
db2233419813f797ba26a6044194bd4f
|
|
| BLAKE2b-256 |
4cd059d04993e4f062161c3cfe557483676129365078dd99ecc31aea77bb0508
|
Provenance
The following attestation bundles were made for opendroid_agi-1.0.7-py3-none-any.whl:
Publisher:
workflow.yml on py811332-a11y/OpenDroid
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
opendroid_agi-1.0.7-py3-none-any.whl -
Subject digest:
af0b44b5dc012474ad88e87e8cd6c859c36e0aa9af8f9f589fdea889fb94b9a7 - Sigstore transparency entry: 1276919928
- Sigstore integration time:
-
Permalink:
py811332-a11y/OpenDroid@04e17ea72eb5258246b77e4c72047d9e568d6c8f -
Branch / Tag:
refs/tags/v1.0.7 - Owner: https://github.com/py811332-a11y
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@04e17ea72eb5258246b77e4c72047d9e568d6c8f -
Trigger Event:
push
-
Statement type: