Skip to main content

Python Client

This directory contains the publishable Python CLI package for the AIVane Android REPL beta.

Run

After installation, use the console script:

agent-android --help
agent-android --repl --url http://<device-ip>:8080
agent-android --health --url http://<device-ip>:8080

If the phone requires a shared token:

agent-android --repl --url http://<device-ip>:8080 --token YOUR_TOKEN

Set the environment variable AIVANE_API_TOKEN when you prefer not to pass the token on every command line.

Inside the REPL you can also persist it locally:

set token YOUR_TOKEN

For prepared multi-step flows:

agent-android --template template.json --url http://<device-ip>:8080
agent-android --template template.json --async --url http://<device-ip>:8080

For a workflow bundle with one main template plus child templates:

agent-android --application-bundle app.zip --main-template-file __main__.json --url http://<device-ip>:8080
agent-android --application-bundle app.zip --main-template-file __main__.json --async --url http://<device-ip>:8080

Async execution returns a taskId immediately. Poll or stop the task with:

agent-android --task TASK_ID --url http://<device-ip>:8080
agent-android --task-logs TASK_ID --url http://<device-ip>:8080
agent-android --stop-task TASK_ID --url http://<device-ip>:8080

For syncing templates, images, or other files from your computer to the phone:

agent-android --upload foo.json --remote-path Templates/foo.json --url http://<device-ip>:8080
agent-android --upload foo.json --remote-path Templates/foo.json --no-overwrite --url http://<device-ip>:8080

--upload overwrites by default. It uses the same phone-side token check as the other protected REPL endpoints.

Package Layout

  • pyproject.toml: setuptools package metadata and console-script registration
  • src/agent_android/: installable package source
  • tests/: unit and device smoke tests

Notes

  • The package uses a standard src layout under src/agent_android.
  • The phone hosts the beta HTTP service locally and the client connects directly to http://<device-ip>:8080 by default. If the phone-side REPL settings use a different port, pass that port in --url.
  • If a command cannot connect, first check whether the AIVane app or its local API service has exited on the phone, then retry /health.

Metadata

Release files for aivane-agent-android 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aivane-agent-android 0.1.8
File Size Uploaded Provenance Actions
aivane_agent_android-0.1.8.tar.gz 44.1 kB With provenance Details for aivane_agent_android-0.1.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aivane-agent-android 0.1.8
File Interpreter ABI Platform Actions
aivane_agent_android-0.1.8-py3-none-any.whl Python 3 none any Details for aivane_agent_android-0.1.8-py3-none-any.whl

Total release size: 90.2 kB

Release files / aivane_agent_android-0.1.8.tar.gz

Download URL aivane_agent_android-0.1.8.tar.gz
Size 44.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c9e897d25e94f3af093ba26687a5362577f036f1a31f04bcc4ba6b60a967a82a
BLAKE2b-256 checksum
How to use checksums
d20c41c0d01e0074e929b0f084f13e14cc0820713f2f3fdd6129c7710a50d6a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 9, 2026.

Transparency log

Release files / aivane_agent_android-0.1.8-py3-none-any.whl

Download URL aivane_agent_android-0.1.8-py3-none-any.whl
Size 46.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ba24526cc7654cece94d56665b743baec2bdcc10bc5027543c26c9bc30c167c8
BLAKE2b-256 checksum
How to use checksums
36bfa6acba1429fae4e1b4b6217fdac59e9035646c7cfcc8f934e4f9368f3ab4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 9, 2026.

Transparency log

Security for aivane-agent-android 0.1.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aivane_agent_android-0.1.8.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page