Metadata-Version: 2.4
Name: mlx-warmup-kit
Version: 0.1.1
Summary: Multilogin browser warmup pipeline — YAML recipes for proxy, CDP, and human-like cadence. CLI: mlx-warmup.
Project-URL: Homepage, https://pypi.org/project/mlx-warmup-kit/
Project-URL: Documentation, https://pypi.org/project/mlx-warmup-kit/
Project-URL: Repository, https://pypi.org/project/mlx-warmup-kit/
Project-URL: Changelog, https://pypi.org/project/mlx-warmup-kit/
Author: mlx-warmup-kit contributors
License-Expression: MIT
License-File: LICENSE
Keywords: account-warmup,antidetect-warmup,browser-warmup,folder-warmup,human-like-warmup,launcher-cdp,mlx-warmup,multilogin-warmup,new-profile-cadence,playwright-warmup,profile-onboarding,profile-warmup,saas50,warmup-pipeline
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

# mlx-warmup-kit

**Multilogin browser warmup pipeline** — YAML recipes linking proxy, CDP, human-like cadence, and exposure probes.

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

```bash
pip install mlx-warmup-kit
mlx-warmup plan --format markdown
```

CLI: **`mlx-warmup`** · Python **3.10+** · planner only (peer tools on PyPI)

> **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).

Plan **folder-scale warmup** as a repeatable recipe — proxy check → fingerprint lint → Launcher CDP → human-like scroll → exposure probe inside isolated MLX profiles.

## Problem

New MLX profiles get flagged when teams skip ordered warmup. Ad-hoc scripts forget proxy validation or probe the wrong browser context. `mlx-warmup` documents the fleet pipeline as YAML you can validate and render to shell/markdown.

## Install

```bash
pip install mlx-warmup-kit
```

## Quick start

```bash
mlx-warmup template -o warmup.yaml
mlx-warmup validate warmup.yaml
mlx-warmup plan warmup.yaml --format shell -o run-warmup.sh
chmod +x run-warmup.sh
```

## When new profiles still get flagged (playbook)

| Step skipped | Risk | Tool on PyPI |
|--------------|------|--------------|
| Proxy check | Wrong geo / dead exit | `proxy-lane-checker` |
| Fingerprint lint | UA/screen drift | `fingerprint-coherence` |
| Vanilla Chrome warmup | webdriver leaks | `cdp-connect-kit` + `human-input-kit` |
| No exposure probe | Ship blind | `playwright-cdp-probe` |

**Default fleet pipeline:**

```bash
mlx-warmup plan --format shell -o warmup.sh
export MLX_TOKEN=... PROFILE_UUID=...
bash warmup.sh
farm-runner mlx-pool --folder-id FOLDER --script ./warmup_child.py  # scale
```

**Coupon hubs:** [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/) — `SAAS50` browser warmup at scale.

## CLI

| Command | Description |
|---------|-------------|
| `mlx-warmup default` | Print default recipe JSON |
| `mlx-warmup validate FILE` | Lint recipe YAML |
| `mlx-warmup plan [FILE]` | Render markdown / shell / json |
| `mlx-warmup template` | Write starter recipe |
| `mlx-warmup --show-deal` | Opt-in coupons |

## Limitations

- **Planner only** — does not install peer packages or call MLX APIs.
- **Chromium browser path** — recipe targets Launcher CDP, not cloud phone apps.
- **You run the commands** — `plan --format shell` emits a script template.

## Production

Pair rendered shell plans with [automation-farm-runner](https://pypi.org/project/automation-farm-runner/) `mlx-pool` for N-profile folders.

**Partner note (affiliate):** Folder warmup needs **Multilogin X** Launcher CDP — code **`SAAS50`** at [multilogin.com](https://multilogin.com?a_aid=saas). Full disclosure: [docs/AFFILIATE.md](docs/AFFILIATE.md). Deals hubs: [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). Coupons: `mlx-warmup --show-deal`.

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

## Related tools (on PyPI)

| Package | CLI | Role |
|---------|-----|------|
| [human-input-kit](https://pypi.org/project/human-input-kit/) | `human-input` | Human-like scroll/mouse |
| [cdp-connect-kit](https://pypi.org/project/cdp-connect-kit/) | `cdp-connect` | MLX Launcher CDP |
| [cloud-phone-kit](https://pypi.org/project/cloud-phone-kit/) | `cloud-phone` | Cloud Phone readiness |
| [automation-farm-runner](https://pypi.org/project/automation-farm-runner/) | `farm-runner` | mlx-pool queue |

## License

MIT

---

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