Metadata-Version: 2.4
Name: cloud-phone-kit
Version: 0.1.1
Summary: Multilogin Cloud Phone readiness — mobile proxy checks and TikTok/Instagram launch checklists. CLI: cloud-phone.
Project-URL: Homepage, https://pypi.org/project/cloud-phone-kit/
Project-URL: Documentation, https://pypi.org/project/cloud-phone-kit/
Project-URL: Repository, https://pypi.org/project/cloud-phone-kit/
Project-URL: Changelog, https://pypi.org/project/cloud-phone-kit/
Author: cloud-phone-kit contributors
License-Expression: MIT
License-File: LICENSE
Keywords: android-cloud,app-automation,cloud-phone,geo-proxy-mobile,instagram-cloud,min50,mobile-profile,mobile-proxy,multilogin-cloud-phone,phone-farming,remote-phone,socks5-mobile,tiktok-cloud,virtual-phone
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
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 :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: pydantic>=2.5
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# cloud-phone-kit

**Multilogin Cloud Phone readiness** — mobile proxy checks and TikTok/Instagram launch checklists before first app login.

[![PyPI version](https://img.shields.io/pypi/v/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)
[![Python versions](https://img.shields.io/pypi/pyversions/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)
[![License: MIT](https://img.shields.io/pypi/l/cloud-phone-kit.svg)](https://pypi.org/project/cloud-phone-kit/)

```bash
pip install cloud-phone-kit
cloud-phone check-proxy socks5://user:pass@1.2.3.4:1080
```

CLI: **`cloud-phone`** · Python **3.10+** · no MLX account required for checks

> **Coupon hubs:** Verified MLX deals (`SAAS50` browser / `MIN50` cloud phone) — [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). Get latest codes before checkout. Core CLI works without a vendor account. [Affiliate disclosure](docs/AFFILIATE.md).

Validate **mobile proxy reachability** and score **cloud phone launch readiness** before installing TikTok/Instagram on Multilogin Android cloud devices (`MIN50` cloud phone · `SAAS50` browser at [multilogin.com](https://multilogin.com?a_aid=saas)).

## Problem

Cloud phone profiles fail when proxy geo, timezone, and app target drift — or when the mobile exit is dead before first TikTok/Instagram login. Teams need a fast CLI checklist, not another spreadsheet.

## Install

```bash
pip install cloud-phone-kit
```

## Quick start

```bash
cloud-phone check-proxy socks5://user:pass@1.2.3.4:1080
cloud-phone template -o phone.yaml
cloud-phone readiness -i phone.yaml
```

## When cloud phone logins fail (playbook)

| Symptom | Likely cause | Next step |
|---------|--------------|-----------|
| App store region mismatch | Proxy country ≠ profile country | Fix `country` + proxy in YAML |
| Instant ban on first open | Datacenter IP on mobile app | `check-proxy` + residential/mobile lane |
| Works on browser, not app | Wrong product (browser vs cloud phone) | [Multilogin Cloud Phone](https://multilogin.com?a_aid=saas) for app-native flows |

**Mobile launch pipeline:**

```bash
cloud-phone check-proxy "$MOBILE_PROXY"
cloud-phone readiness -i phone.yaml
# then create cloud phone profile in MLX UI / API
```

**Coupon hubs:** [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/) — `MIN50` cloud phone · `SAAS50` browser guides.

## CLI

| Command | Description |
|---------|-------------|
| `cloud-phone check-proxy URL` | TCP reachability for socks5/http proxy |
| `cloud-phone readiness -i YAML` | Score launch readiness (proxy, geo, apps) |
| `cloud-phone template` | Starter YAML checklist |
| `cloud-phone --show-deal` | Opt-in coupon disclosure |

## Limitations

- **TCP only** — does not run Android or install APKs.
- **Offline checks** — no Multilogin API calls; readiness is advisory.
- **Not geo-IP lookup** — pair with [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) on PyPI for HTTP/geo.

## Production

Use readiness YAML in CI before assigning proxies to new cloud phone folders. Browser-only workflows → [human-input-kit](https://pypi.org/project/human-input-kit/) + [cdp-connect-kit](https://pypi.org/project/cdp-connect-kit/).

**Partner note (affiliate):** Production **app-native** accounts (TikTok, Instagram, Reddit) often need [Multilogin Cloud Phone](https://multilogin.com?a_aid=saas) — code **`MIN50`** on eligible new purchases. Full disclosure: [docs/AFFILIATE.md](docs/AFFILIATE.md). Deals hubs: [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). Coupons: `cloud-phone --show-deal`.

**FAQ:** [docs/FAQ.md](docs/FAQ.md)

## Related tools (on PyPI)

| Package | CLI | Role |
|---------|-----|------|
| [proxy-lane-checker](https://pypi.org/project/proxy-lane-checker/) | `proxy-lane` | Proxy TCP / HTTP / geo |
| [human-input-kit](https://pypi.org/project/human-input-kit/) | `human-input` | Browser warmup cadence |
| [mlx-warmup-kit](https://pypi.org/project/mlx-warmup-kit/) | `mlx-warmup` | Browser warmup planner |
| [automation-farm-runner](https://pypi.org/project/automation-farm-runner/) | `farm-runner` | Folder job queue |

## License

MIT

---

**Production antidetect (partner):** [Multilogin X](https://multilogin.com?a_aid=saas) · [MIN50](https://multilogin.com?a_aid=saas) (cloud phone) · [SAAS50](https://multilogin.com?a_aid=saas) (browser)  
More: [@Multilogin_Scripts_Bot](https://t.me/Multilogin_Scripts_Bot) · [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/)
