Skip to main content

The Open-Source Mobile Native AGI. Appium Replacement and Termux Automator.

Project description

OpenDroid Autonomous Mobile Agent

📱 OpenDroid Framework

The Most Advanced, Autonomous, Single-Click Mobile Agent on Earth.

Move over Desktop Agents. The Future of AI is Mobile.

Open Source PyPI version Security Layer OS Compat

Global PyPI InstallationClaude Code & CursorEnterprise QAWhy 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opendroid_agi-1.0.6.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

opendroid_agi-1.0.6-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file opendroid_agi-1.0.6.tar.gz.

File metadata

  • Download URL: opendroid_agi-1.0.6.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for opendroid_agi-1.0.6.tar.gz
Algorithm Hash digest
SHA256 ee245d1e121659fddf4afe3560d2ec82f527aed71197773fb5f37f555345d424
MD5 42535f8f285b7ed73d67be47c31ab238
BLAKE2b-256 f30a0e14856d4ed1d1603a260907399a268735ea73b26e62161f7fee15439ade

See more details on using hashes here.

Provenance

The following attestation bundles were made for opendroid_agi-1.0.6.tar.gz:

Publisher: workflow.yml on py811332-a11y/OpenDroid

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file opendroid_agi-1.0.6-py3-none-any.whl.

File metadata

  • Download URL: opendroid_agi-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 5.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for opendroid_agi-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 bd898d37fce98ca17af96b13d44d13c9cf1e886a874c285049efdeff9647b5d3
MD5 796e39c972753a5275e3b7ab4272508a
BLAKE2b-256 0fc9b1a0f8835cc8b0c2d298adc7c0a457d463daa8b0360eeffadcf49fa3781f

See more details on using hashes here.

Provenance

The following attestation bundles were made for opendroid_agi-1.0.6-py3-none-any.whl:

Publisher: workflow.yml on py811332-a11y/OpenDroid

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page