droidrun 0.3.8__tar.gz → 0.3.10.dev2__tar.gz

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/.github/workflows/publish.yml

@@ -1,12 +1,10 @@
 name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
-
 on: push
 
 jobs:
   build:
     name: Build distribution 📦
     runs-on: ubuntu-latest
-
     steps:
     - uses: actions/checkout@v4
       with:
@@ -29,49 +27,47 @@ jobs:
         name: python-package-distributions
         path: dist/
 
-  publish-to-pypi:
-    name: >-
-      Publish Python 🐍 distribution 📦 to PyPI
-    if: startsWith(github.ref, 'refs/tags/')
+  publish-to-testpypi:
+    name: Publish Python 🐍 distribution 📦 to TestPyPI
+    # Only runs on dev branch
+    if: github.ref == 'refs/heads/dev'
     needs:
     - build
     runs-on: ubuntu-latest
     environment:
-      name: pypi
-      url: https://pypi.org/p/droidrun 
+      name: testpypi
+      url: https://test.pypi.org/p/droidrun
     permissions:
       id-token: write
-
     steps:
     - name: Download all the dists
       uses: actions/download-artifact@v4
       with:
         name: python-package-distributions
         path: dist/
-    - name: Publish distribution 📦 to PyPI
+    - name: Publish distribution 📦 to TestPyPI
       uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
 
-  publish-to-testpypi:
-    name: Publish Python 🐍 distribution 📦 to TestPyPI
-    if: startsWith(github.ref, 'refs/tags/')
+  publish-to-pypi:
+    name: >-
+      Publish Python 🐍 distribution 📦 to PyPI
+    # Only runs on production tags (v*)
+    if: startsWith(github.ref, 'refs/tags/v')
     needs:
     - build
     runs-on: ubuntu-latest
-
     environment:
-      name: testpypi
-      url: https://test.pypi.org/p/droidrun
-
+      name: pypi
+      url: https://pypi.org/p/droidrun 
     permissions:
       id-token: write
-
     steps:
     - name: Download all the dists
       uses: actions/download-artifact@v4
       with:
         name: python-package-distributions
         path: dist/
-    - name: Publish distribution 📦 to TestPyPI
-      uses: pypa/gh-action-pypi-publish@release/v1
-      with:
-        repository-url: https://test.pypi.org/legacy/
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/.gitignore

@@ -23,7 +23,4 @@ patch_apis.py
 .git
 .arize-phoenix
 
-
-uv.lock
-
 todo.txt

droidrun-0.3.10.dev2/.python-version

@@ -0,0 +1 @@
+3.13.7

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: droidrun
-Version: 0.3.8
+Version: 0.3.10.dev2
 Summary: A framework for controlling Android devices through LLM agents
 Project-URL: Homepage, https://github.com/droidrun/droidrun
 Project-URL: Bug Tracker, https://github.com/droidrun/droidrun/issues
@@ -16,6 +16,8 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
@@ -25,16 +27,16 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Testing :: Acceptance
 Classifier: Topic :: System :: Emulators
 Classifier: Topic :: Utilities
-Requires-Python: >=3.11
+Requires-Python: >=3.13
 Requires-Dist: adbutils>=2.10.2
 Requires-Dist: apkutils==2.0.0
-Requires-Dist: llama-index==0.13.6
-Requires-Dist: posthog>=6.7.4
-Requires-Dist: pydantic>=2.11.7
+Requires-Dist: llama-index==0.14.4
+Requires-Dist: posthog>=6.7.6
+Requires-Dist: pydantic>=2.11.10
 Requires-Dist: rich>=14.1.0
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.67.0; extra == 'anthropic'
-Requires-Dist: llama-index-llms-anthropic>=0.8.6; extra == 'anthropic'
+Requires-Dist: llama-index-llms-anthropic<0.9.0,>=0.8.6; extra == 'anthropic'
 Provides-Extra: deepseek
 Requires-Dist: llama-index-llms-deepseek>=0.2.1; extra == 'deepseek'
 Provides-Extra: dev
@@ -51,6 +53,10 @@ Provides-Extra: openai
 Requires-Dist: llama-index-llms-openai-like>=0.5.1; extra == 'openai'
 Requires-Dist: llama-index-llms-openai>=0.5.6; extra == 'openai'
 Requires-Dist: openai>=1.99.1; extra == 'openai'
+Provides-Extra: openrouter
+Requires-Dist: llama-index-llms-openrouter>=0.4.2; extra == 'openrouter'
+Provides-Extra: phoenix
+Requires-Dist: arize-phoenix>=12.3.0; extra == 'phoenix'
 Description-Content-Type: text/markdown
 
 <picture>
@@ -88,7 +94,7 @@ DroidRun is a powerful framework for controlling Android and iOS devices through
 ## 📦 Installation
 
 ```bash
-pip install droidrun[google,anthropic,openai,deepseek,ollama,dev]
+pip install 'droidrun[google,anthropic,openai,deepseek,ollama,dev]'
 ```
 
 ## 🚀 Quickstart

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/README.md

@@ -33,7 +33,7 @@ DroidRun is a powerful framework for controlling Android and iOS devices through
 ## 📦 Installation
 
 ```bash
-pip install droidrun[google,anthropic,openai,deepseek,ollama,dev]
+pip install 'droidrun[google,anthropic,openai,deepseek,ollama,dev]'
 ```
 
 ## 🚀 Quickstart

droidrun-0.3.10.dev2/config.yaml

@@ -0,0 +1,91 @@
+# DroidRun Configuration File
+# This file is auto-generated. Edit values as needed.
+
+# === Agent Settings ===
+agent:
+  # Maximum number of steps per task
+  max_steps: 15
+  # Enable vision capabilities per agent (screenshots)
+  vision:
+    manager: true
+    executor: true
+    codeact: true
+  # Enable planning with reasoning mode
+  reasoning: true
+  # Sleep duration after each action, waits for ui state to be updated (seconds)
+  after_sleep_action: 1.0
+
+
+  wait_for_stable_ui: 0.3 # TODO: doesn't do anything now
+
+# === LLM Profiles ===
+# Define LLM configurations for each agent type
+llm_profiles:
+  # Manager: Plans and reasons about task progress
+  manager:
+    provider: GoogleGenAI
+    model: models/gemini-2.5-pro
+    temperature: 0.2
+    # kwargs: # optional kwargs, add api_key in kwargs if not already in .env
+    #   max_tokens: 8192
+      
+  # Executor: Selects and executes atomic actions
+  executor:
+    provider: GoogleGenAI
+    model: models/gemini-2.5-pro
+    temperature: 0.1
+    # kwargs:
+    #   max_tokens: 4096
+      
+  # CodeAct: Generates and executes code actions
+  codeact:
+    provider: GoogleGenAI
+    model: models/gemini-2.5-pro
+    temperature: 0.2
+    # kwargs:
+    #   max_tokens: 8192
+      
+  # Text Manipulator: Edits text in input fields
+  text_manipulator:
+    provider: GoogleGenAI
+    model: models/gemini-2.5-flash
+    temperature: 0.3
+    # kwargs:
+    #   max_tokens: 4096
+      
+  # App Opener: Opens apps by name/description
+  app_opener:
+    provider: GoogleGenAI
+    model: models/gemini-2.5-flash
+    temperature: 0.0
+    # kwargs:
+    #   max_tokens: 512
+
+# === Device Settings ===
+device:
+  # Default device serial (null = auto-detect)
+  serial: null
+  # Use TCP communication instead of usb
+  use_tcp: false
+
+# === Telemetry Settings ===
+telemetry:
+  # Enable anonymous telemetry
+  enabled: false
+
+# === Tracing Settings ===
+tracing:
+  # Enable Arize Phoenix tracing
+  enabled: false
+
+# === Logging Settings ===
+logging:
+  # Enable debug logging
+  debug: true
+  # Trajectory saving level (none, step, action)
+  save_trajectory: none
+
+# === Tool Settings ===
+tools:
+  # Enable drag tool
+  allow_drag: false # this does nothing now place holder for now

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/docs.json

@@ -14,7 +14,7 @@
         "tab": "Framework",
         "versions": [
           {
-            "version": "0.3.6",
+            "version": "0.3.8",
             "groups": [
               {
                 "group": "Introduction",

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/guides/cli.mdx

@@ -13,7 +13,7 @@ DroidRun lets you control Android devices using natural language and LLM agents.
 <Steps>
     <Step title="Install DroidRun and its dependencies. Choose which ever provider you'd like to use.">
        ```sh 
-       pip install droidrun[google,anthropic,openai,deepseek,ollama,dev]
+       pip install 'droidrun[google,anthropic,openai,deepseek,ollama,dev]'
        ```
     </Step>
     <Step title="Ensure your Android device is connected and the DroidRun Portal is installed">

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/guides/gemini.mdx

@@ -32,7 +32,7 @@ Make sure you've set up and enabled the Droidrun Portal.
 ## 2. Install Required Python Packages
 
 ```sh
-pip install droidrun[google]
+pip install 'droidrun[google]'
 ```
 
 ## 3. Example: Using Droidrun with Gemini LLM

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/guides/ollama.mdx

@@ -47,7 +47,7 @@ ollama pull llama4
 Make sure you have the required Python packages:
 
 ```sh
-pip install droidrun[ollama]
+pip install 'droidrun[ollama]'
 ```
 
 ## 3. Example: Using Droidrun with Ollama LLM

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/guides/openailike.mdx

@@ -36,7 +36,7 @@ Get your API key for the provider you've choosen
 ## 2. Install the required Python packages:
 
 ```sh
-pip install droidrun[openai]
+pip install 'droidrun[openai]'
 ```
 
 ## 3. Example: Using Droidrun with OpenAI-like LLM

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/overview.mdx

@@ -29,7 +29,7 @@ DroidRun empowers you to automate sophisticated mobile workflows through intelli
 <Card icon="mobile" title="Physical Device" href="/v3/quickstart" arrow>
  - Connect your own physical Android device for direct automation
 </Card>
-<Card icon="cloud" title="Cloud Environment" href="https://droidrun.ai/cloud">
+<Card icon="cloud" title="Cloud Environment" href="https://cloud.droidrun.ai">
  - Access our managed cloud environment for instant mobile app automation without any setup.
 </Card>
 </CardGroup>

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/docs/v3/quickstart.mdx

@@ -28,7 +28,7 @@ Before installing DroidRun, ensure you have:
 ### Install from PyPI
 Choose which ever provider you'd like to use. If you encounter dependency resolution issues use [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
 ```bash
-pip install droidrun[google,anthropic,openai,deepseek,ollama,dev]
+pip install 'droidrun[google,anthropic,openai,deepseek,ollama,dev]'
 ```
 
 ### Setup the Portal APK

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/droidrun/__init__.py

@@ -5,13 +5,12 @@ DroidRun - A framework for controlling Android devices through LLM agents.
 __version__ = "0.3.0"
 
 # Import main classes for easier access
-from droidrun.agent.utils.llm_picker import load_llm
-from droidrun.tools import Tools, AdbTools, IOSTools
 from droidrun.agent.droid import DroidAgent
+from droidrun.agent.utils.llm_picker import load_llm
 
 # Import macro functionality
 from droidrun.macro import MacroPlayer, replay_macro_file, replay_macro_folder
-
+from droidrun.tools import AdbTools, IOSTools, Tools
 
 # Make main components available at package level
 __all__ = [

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/droidrun/__main__.py

@@ -4,4 +4,4 @@ DroidRun main entry point
 from droidrun.cli.main import cli
 
 if __name__ == '__main__':
-    cli()
+    cli()

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/droidrun/agent/__init__.py

@@ -3,4 +3,4 @@
 #logger = logging.getLogger("droidrun")
 #logger.propagate = False  # Don't send to root logger
 #logger.handlers = []      # No handlers by default
-#logger.setLevel(logging.INFO)  # Or WARNING
+#logger.setLevel(logging.INFO)  # Or WARNING

{droidrun-0.3.8 → droidrun-0.3.10.dev2}/droidrun/agent/codeact/__init__.py

@@ -1,8 +1,5 @@
 from droidrun.agent.codeact.codeact_agent import CodeActAgent
-from droidrun.agent.codeact.prompts import (
-    DEFAULT_CODE_ACT_USER_PROMPT,
-    DEFAULT_NO_THOUGHTS_PROMPT
-)
+from droidrun.agent.codeact.prompts import DEFAULT_CODE_ACT_USER_PROMPT, DEFAULT_NO_THOUGHTS_PROMPT
 
 __all__ = [
     "CodeActAgent",