Invi Labs Python SDK

Automate real iPhones through the Invi Labs API using your API key and phone ID. Non-jailbroken iPhones require Invi Dongle.

Install

python -m pip install invilabs

Requires Python 3.10 or newer. No third-party runtime dependencies.

Connect and run an action

Set INVI_API_KEY and INVI_PHONE_ID in your environment. Keep your API key private.

import os
from invilabs import Client

client = Client(os.environ["INVI_API_KEY"])
phone = client.phone(os.environ["INVI_PHONE_ID"])

print(phone.details())
phone.tap(100, 200)
phone.save_screenshot("screen.png")

Coordinates use full-resolution screenshot pixels. Calls block until completion; the SDK waits and retries when the phone reports device_busy. Uncertain execution is not automatically repeated. Use the operation key to look up its status.

AI generation

result = client.generate(
    "Generate an email address using example.com",
    result_type="email",
)
print(result["data"]["text"])
print(client.balance())

Generation supports text, usernames and email address strings, optionally using a local PNG/JPEG image. It does not create mailboxes. OCR, AI prompts and generation use your shared Account AI balance. No AI-provider key is required.

Features

  • Tap, swipe, scroll, type, explicit key presses and opening installed apps.
  • Screenshots as PNG bytes or saved to your computer.
  • Grouped OCR with text and bounding boxes.
  • Single-action AI prompts and structured screen answers.
  • Image/video import through Invi Helper on supported dongle phones.
  • Device details, balance and operation recovery.

All network operations use the public HTTPS API with your API key. The package contains client code and response contracts; phone control and AI processing run on Invi Labs services. API keys remain on your computer and are sent only as an authentication header to the configured API. HTTP redirects are not followed.

This is an initial release. Device support and feature verification limits are listed in the release notes.

Documentation · Quickstart · Generation and outputs · Errors and recovery

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for invilabs from gravatar.com invilabs

Credits

Author: Invi Labs

Requires

Python >=3.10

Tags

iphone automation sdk ai-agent ocr

Classifiers

Report project as malware

Download files

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

Source Distribution

invilabs-0.1.0.tar.gz (15.0 kB view details)

Uploaded Source

Built Distribution

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

invilabs-0.1.0-py3-none-any.whl (15.9 kB view details)

Uploaded Python 3

File details

Details for the file invilabs-0.1.0.tar.gz.

File metadata

  • Download URL: invilabs-0.1.0.tar.gz
  • Upload date:
  • Size: 15.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invilabs-0.1.0.tar.gz
Algorithm Hash digest
SHA256 887ef6ec16b0b77a5625e422c70c76803735924bfed94aabf9b32734c5fcc130
MD5 416933f62a3b838868cd3123217d2c35
BLAKE2b-256 4d71b8f578b74915c8a4203820b53511d9963b027d00b2f568535b9d64c560b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for invilabs-0.1.0.tar.gz:

Publisher: publish-sdk.yml on invictusro/invilabs-api

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

File details

Details for the file invilabs-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: invilabs-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for invilabs-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 844ceaa2be25b0c483212bb32d2624535dd6b9b18704eabc9003b30df7d96d18
MD5 79c57ac108c799353549e7a8848a5a60
BLAKE2b-256 b82da80acc63329d42e47af288a3494efac9becf858210268c64e41a03ae43c1

See more details on using hashes here.

Provenance

The following attestation bundles were made for invilabs-0.1.0-py3-none-any.whl:

Publisher: publish-sdk.yml on invictusro/invilabs-api

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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

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