# minitap — Python Meta‑Package

[![PyPI version](https://img.shields.io/pypi/v/minitap.svg)](https://pypi.org/project/minitap/)
[![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)

A lightweight meta-package that installs Minitap Python libraries under one name. Today it bundles the mobile automation project: `minitap-mobile-use`.

**Python Compatibility: >= 3.12**

## Table of Contents
- [Version Management](#version-management)
    - [Dependency Management Options](#dependency-management-options)
- [What you get](#what-you-get)
    - [About mobile-use](#about-mobile-use)
- [Why a meta‑package?](#why-a-meta-package)
- [Links](#links)
- [License](#license)

## Version Management

This package is only updated:
- When one of the Minitap Python packages has a change in MAJOR version (refer to [Semantic Versioning](https://semver.org/))
- Or when a new Minitap Python package is added

### Dependency Management Options

For precise control over packages and versions, install specific packages directly:
- **mobile-use:** `pip install minitap-mobile-use==x.x.x` ([PyPI](https://pypi.org/project/minitap-mobile-use/))

## What you get

Installing `minitap` pulls in:

- `minitap-mobile-use` — Control Android/iOS devices using natural language. After install, its code is available via `import minitap.mobile_use` (exposed by the dependency itself).

### About mobile-use

Mobile-use is an open-source AI agent that:
- Understands natural language instructions
- Navigates app UIs
- Can scrape and return structured data (e.g., JSON)
- Is configurable with different LLMs

Benchmarks and details: https://minitap.ai/research/mobile-ai-agents-benchmark

## Why a meta‑package?

`minitap` provides a single pip install that brings in Minitap public Python packages. There is no runtime API in this package itself; it only manages dependencies.

## Links

- Website: https://minitap.ai/
- Source (mobile-use): https://github.com/minitap-ai/mobile-use
- Issues/Support: please open issues on the mobile-use repo.

## License

Each included project follows its own license. See the respective repositories for details.