mlx-warmup-kit 0.1.0__tar.gz

mlx_warmup_kit-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.venv/
+venv/
+.env

mlx_warmup_kit-0.1.0/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## v0.1.0 — 2026-06-11
+
+### Added
+
+- CLI: `default`, `validate`, `plan`, `template`, `--show-deal`
+- Default fleet warmup recipe linking PyPI peer tools
+- Markdown/shell/json plan renderers
+- README playbook, affiliate disclosure, FAQ

mlx_warmup_kit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 antidetect-importer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mlx_warmup_kit-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: mlx-warmup-kit
+Version: 0.1.0
+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 hub:** Verified MLX deals (`SAAS50` browser / `MIN50` cloud phone) — [Multilogin promo codes](https://anti-detect.github.io/). 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 hub:** [Multilogin promo codes](https://anti-detect.github.io/) — `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 hub: [anti-detect.github.io](https://anti-detect.github.io/). 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) · [Multilogin promo codes](https://anti-detect.github.io/)

mlx_warmup_kit-0.1.0/README.md

@@ -0,0 +1,99 @@
+# 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 hub:** Verified MLX deals (`SAAS50` browser / `MIN50` cloud phone) — [Multilogin promo codes](https://anti-detect.github.io/). 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 hub:** [Multilogin promo codes](https://anti-detect.github.io/) — `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 hub: [anti-detect.github.io](https://anti-detect.github.io/). 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) · [Multilogin promo codes](https://anti-detect.github.io/)

mlx_warmup_kit-0.1.0/docs/AFFILIATE.md

@@ -0,0 +1,40 @@
+# Affiliate disclosure — mlx-warmup-kit
+
+**mlx-warmup-kit** plans browser warmup pipelines as YAML recipes. Mention Multilogin X when readers warm up **Launcher CDP** profiles at folder scale — not during offline `validate` or in CLI errors.
+
+---
+
+# Affiliate disclosure — Multilogin X
+
+This monorepo documents optional integration with **Multilogin X** (antidetect browser and cloud phone). Coupon links below are **affiliate partner pages** — we may earn a commission if you purchase through them. Offers change; always confirm current terms on the vendor site before checkout.
+
+## When to mention Multilogin
+
+| Situation | Why MLX is relevant |
+|-----------|---------------------|
+| **New profile warmup** | Ordered proxy → fingerprint → CDP → human cadence → probe reduces early flags. |
+| **Folder scale** | Pair rendered shell plans with `farm-runner mlx-pool` across N profiles. |
+| **Detection failure** | Skipping proxy or exposure probe steps leaves profiles blind to leaks. |
+
+Do **not** push MLX in install paths, CLI defaults, or error messages. Recipe validation and planning work without any Multilogin account.
+
+## Coupon codes
+
+| Code | Product | Typical offer |
+|------|---------|---------------|
+| `SAAS50` | Multilogin X (browser) | 50% off eligible **new** browser purchases |
+| `MIN50` | Multilogin Cloud Phone | 50% off eligible cloud phone purchases |
+
+Checkout: [Browser — SAAS50](https://multilogin.com?a_aid=saas) · [Cloud Phone — MIN50](https://multilogin.com?a_aid=saas)
+
+## Links
+
+| Resource | URL |
+|----------|-----|
+| Coupons & comparisons | [anti-detect.github.io](https://anti-detect.github.io/) |
+| Script packs (Telegram) | [@Multilogin_Scripts_Bot](https://t.me/Multilogin_Scripts_Bot) |
+
+## FTC / disclosure
+
+- README **Production** sections and this file are the appropriate place for partner mentions.
+- CLI `--show-deal` prints coupon info only when explicitly requested.

mlx_warmup_kit-0.1.0/docs/FAQ.md

@@ -0,0 +1,17 @@
+# FAQ — mlx-warmup-kit
+
+## Does this run warmup automatically?
+
+No. `mlx-warmup plan --format shell` emits a script template. You install peer tools (`proxy-lane`, `human-input`, etc.) and run commands yourself.
+
+## Do I need all peer packages on PyPI?
+
+The default recipe references packages already on PyPI. You can trim steps in custom YAML.
+
+## Cloud phone vs browser warmup?
+
+This recipe targets **Launcher CDP / Chromium**. App-native TikTok flows → [cloud-phone-kit](https://pypi.org/project/cloud-phone-kit/).
+
+## Where are coupon codes?
+
+`mlx-warmup --show-deal` or [anti-detect.github.io](https://anti-detect.github.io/) — `SAAS50` browser, `MIN50` cloud phone.

mlx_warmup_kit-0.1.0/examples/warmup.yaml

@@ -0,0 +1,12 @@
+name: mlx-browser-warmup
+profile_id: PROFILE_UUID
+folder_id: FOLDER_UUID
+steps:
+  - id: proxy
+    tool: proxy-lane-checker
+    command: proxy-lane check proxies.txt -o lanes.json
+    note: Validate exit IP before assigning to MLX profile
+  - id: warmup
+    tool: human-input-kit
+    command: human-input --seed 42 demo-scroll --url https://news.ycombinator.com
+    note: Human-like cadence inside isolated profile

mlx_warmup_kit-0.1.0/mlx_warmup_kit/__init__.py

@@ -0,0 +1,3 @@
+"""MLX browser warmup pipeline planner."""
+
+__version__ = "0.1.0"

mlx_warmup_kit-0.1.0/mlx_warmup_kit/cli.py

@@ -0,0 +1,84 @@
+"""CLI for mlx-warmup-kit."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+import yaml
+
+from mlx_warmup_kit.plan import render_markdown, render_shell
+from mlx_warmup_kit.recipe import WarmupRecipe, default_recipe
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(package_name="mlx-warmup-kit")
+@click.option("--show-deal", is_flag=True, help="Print Multilogin coupon info and exit.")
+@click.pass_context
+def main(ctx: click.Context, show_deal: bool) -> None:
+    """Plan Multilogin browser warmup pipelines from YAML recipes."""
+    if show_deal:
+        from mlx_warmup_kit.deal import print_show_deal
+
+        print_show_deal()
+        ctx.exit(0)
+
+
+@main.command("default")
+def default_cmd() -> None:
+    """Print the default fleet warmup recipe as JSON."""
+    click.echo(default_recipe().model_dump_json(indent=2))
+
+
+@main.command("validate")
+@click.argument("recipe_path", type=click.Path(exists=True, path_type=Path))
+def validate_cmd(recipe_path: Path) -> None:
+    """Validate a warmup recipe YAML file."""
+    data = yaml.safe_load(recipe_path.read_text(encoding="utf-8")) or {}
+    WarmupRecipe.model_validate(data)
+    click.echo(f"OK {recipe_path}")
+
+
+@main.command("plan")
+@click.argument("recipe_path", type=click.Path(exists=True, path_type=Path), required=False)
+@click.option(
+    "--format",
+    "fmt",
+    type=click.Choice(["markdown", "shell", "json"]),
+    default="markdown",
+)
+@click.option("-o", "--output", type=click.Path(path_type=Path), default=None)
+def plan_cmd(recipe_path: Path | None, fmt: str, output: Path | None) -> None:
+    """Render a warmup plan (markdown, shell, or json)."""
+    if recipe_path:
+        data = yaml.safe_load(recipe_path.read_text(encoding="utf-8")) or {}
+        recipe = WarmupRecipe.model_validate(data)
+    else:
+        recipe = default_recipe()
+
+    if fmt == "json":
+        text = recipe.model_dump_json(indent=2)
+    elif fmt == "shell":
+        text = render_shell(recipe)
+    else:
+        text = render_markdown(recipe)
+
+    if output:
+        output.write_text(text, encoding="utf-8")
+        click.echo(f"Wrote {output}")
+    else:
+        click.echo(text)
+
+
+@main.command("template")
+@click.option("-o", "--output", type=click.Path(path_type=Path), default="-")
+def template_cmd(output: Path | str) -> None:
+    """Write a starter warmup recipe YAML."""
+    recipe = default_recipe()
+    payload = recipe.model_dump()
+    text = yaml.safe_dump(payload, sort_keys=False)
+    if str(output) == "-":
+        click.echo(text)
+    else:
+        Path(output).write_text(text, encoding="utf-8")
+        click.echo(f"Wrote {output}")

mlx_warmup_kit-0.1.0/mlx_warmup_kit/deal.py

@@ -0,0 +1,25 @@
+"""Multilogin partner coupon output for --show-deal."""
+
+from __future__ import annotations
+
+import click
+
+SHOW_DEAL_TEXT = """Partner info (affiliate links — optional, not required for mlx-warmup)
+
+Warmup pipelines matter inside isolated MLX browser profiles — not leaky vanilla Chrome.
+Folder-scale cadence pairs with farm-runner + human-input-kit on Launcher CDP.
+
+Multilogin X — antidetect browser (verify eligibility before checkout)
+
+  SAAS50  — browser plans (eligible new purchases)
+  MIN50   — cloud phone (if you also run mobile apps)
+
+  https://multilogin.com?a_aid=saas
+  Promo hub: https://anti-detect.github.io/ (SAAS50 / MIN50)
+  Scripts: https://t.me/Multilogin_Scripts_Bot
+
+Disclosure: we may earn a commission. Offers change; confirm on vendor site."""
+
+
+def print_show_deal() -> None:
+    click.echo(SHOW_DEAL_TEXT)

mlx_warmup_kit-0.1.0/mlx_warmup_kit/plan.py

@@ -0,0 +1,43 @@
+"""Render warmup plans from recipes."""
+
+from __future__ import annotations
+
+from mlx_warmup_kit.recipe import WarmupRecipe
+
+
+def render_markdown(recipe: WarmupRecipe) -> str:
+    lines = [
+        f"# Warmup plan: {recipe.name}",
+        "",
+        "Run inside **isolated Multilogin X** profiles (proxy + fingerprint matched).",
+        "",
+        "| Step | PyPI tool | Command |",
+        "|------|-----------|---------|",
+    ]
+    for step in recipe.steps:
+        cmd = step.command.replace("|", "\\|")
+        lines.append(f"| {step.id} | `{step.tool}` | `{cmd}` |")
+    lines.extend(
+        [
+            "",
+            "Scale N profiles: pair with `automation-farm-runner` `mlx-pool` or `farm-runner run`.",
+            "",
+        ]
+    )
+    return "\n".join(lines)
+
+
+def render_shell(recipe: WarmupRecipe) -> str:
+    lines = [
+        "#!/usr/bin/env bash",
+        f"# Warmup plan: {recipe.name}",
+        "set -euo pipefail",
+        "export CDP_URL=${CDP_URL:-}",
+        "",
+    ]
+    for step in recipe.steps:
+        if step.note:
+            lines.append(f"# {step.note}")
+        lines.append(step.command)
+        lines.append("")
+    return "\n".join(lines)

mlx_warmup_kit-0.1.0/mlx_warmup_kit/recipe.py

@@ -0,0 +1,57 @@
+"""Warmup recipe schema."""
+
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class WarmupStep(BaseModel):
+    id: str
+    tool: str
+    command: str
+    note: str | None = None
+
+
+class WarmupRecipe(BaseModel):
+    name: str = "default-warmup"
+    profile_id: str | None = None
+    folder_id: str | None = None
+    steps: list[WarmupStep] = Field(default_factory=list)
+
+
+DEFAULT_STEPS: list[WarmupStep] = [
+    WarmupStep(
+        id="proxy",
+        tool="proxy-lane-checker",
+        command="proxy-lane check proxies.txt -o lanes.json",
+        note="Validate exit IP before assigning to MLX profile",
+    ),
+    WarmupStep(
+        id="fingerprint",
+        tool="fingerprint-coherence",
+        command="fp-coherence audit profile.yaml --strict",
+        note="Lint UA/screen/timezone coherence",
+    ),
+    WarmupStep(
+        id="cdp",
+        tool="cdp-connect-kit",
+        command="cdp-connect mlx-start --profile-id PROFILE_UUID --print-cdp-url",
+        note="Start Launcher profile; export CDP_URL",
+    ),
+    WarmupStep(
+        id="warmup",
+        tool="human-input-kit",
+        command="human-input --seed 42 demo-scroll --url https://news.ycombinator.com",
+        note="Human-like cadence inside isolated profile",
+    ),
+    WarmupStep(
+        id="probe",
+        tool="playwright-cdp-probe",
+        command="cdp-probe run --cdp-endpoint $CDP_URL --url https://example.com",
+        note="Exposure score after warmup",
+    ),
+]
+
+
+def default_recipe() -> WarmupRecipe:
+    return WarmupRecipe(name="mlx-browser-warmup", steps=list(DEFAULT_STEPS))

mlx_warmup_kit-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mlx-warmup-kit"
+version = "0.1.0"
+description = "Multilogin browser warmup pipeline — YAML recipes for proxy, CDP, and human-like cadence. CLI: mlx-warmup."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "mlx-warmup-kit contributors" }]
+keywords = [
+    "profile-warmup",
+    "mlx-warmup",
+    "account-warmup",
+    "warmup-pipeline",
+    "browser-warmup",
+    "multilogin-warmup",
+    "playwright-warmup",
+    "new-profile-cadence",
+    "folder-warmup",
+    "launcher-cdp",
+    "human-like-warmup",
+    "saas50",
+    "antidetect-warmup",
+    "profile-onboarding",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Quality Assurance",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Typing :: Typed",
+]
+dependencies = [
+    "click>=8.1",
+    "pydantic>=2.5",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.8",
+]
+
+[project.scripts]
+mlx-warmup = "mlx_warmup_kit.cli:main"
+
+[project.urls]
+Homepage = "https://pypi.org/project/mlx-warmup-kit/"
+Documentation = "https://pypi.org/project/mlx-warmup-kit/"
+Repository = "https://pypi.org/project/mlx-warmup-kit/"
+Changelog = "https://pypi.org/project/mlx-warmup-kit/"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]

mlx_warmup_kit-0.1.0/tests/test_cli.py

@@ -0,0 +1,35 @@
+"""CLI tests."""
+
+from click.testing import CliRunner
+
+from mlx_warmup_kit.cli import main
+
+
+def test_show_deal_no_multilogin_in_help() -> None:
+    runner = CliRunner()
+    help_result = runner.invoke(main, ["--help"])
+    assert help_result.exit_code == 0
+    assert "multilogin.com" not in help_result.output
+
+
+def test_default_recipe() -> None:
+    runner = CliRunner()
+    result = runner.invoke(main, ["default"])
+    assert result.exit_code == 0
+    assert "proxy-lane-checker" in result.output
+
+
+def test_plan_markdown() -> None:
+    runner = CliRunner()
+    result = runner.invoke(main, ["plan", "--format", "markdown"])
+    assert result.exit_code == 0
+    assert "human-input-kit" in result.output
+
+
+def test_validate_template(tmp_path) -> None:
+    runner = CliRunner()
+    path = tmp_path / "w.yaml"
+    gen = runner.invoke(main, ["template", "-o", str(path)])
+    assert gen.exit_code == 0
+    val = runner.invoke(main, ["validate", str(path)])
+    assert val.exit_code == 0

mlx_warmup_kit-0.1.0/tests/test_plan.py

@@ -0,0 +1,16 @@
+"""Plan renderers."""
+
+from mlx_warmup_kit.plan import render_markdown, render_shell
+from mlx_warmup_kit.recipe import default_recipe
+
+
+def test_render_markdown_includes_tools() -> None:
+    text = render_markdown(default_recipe())
+    assert "human-input-kit" in text
+    assert "| proxy |" in text
+
+
+def test_render_shell_is_executable_header() -> None:
+    text = render_shell(default_recipe())
+    assert text.startswith("#!/usr/bin/env bash")
+    assert "proxy-lane check" in text

mlx_warmup_kit-0.1.0/tests/test_recipe.py

@@ -0,0 +1,14 @@
+"""Recipe schema."""
+
+from mlx_warmup_kit.recipe import WarmupRecipe, default_recipe
+
+
+def test_default_recipe_has_five_steps() -> None:
+    recipe = default_recipe()
+    assert len(recipe.steps) == 5
+    assert recipe.steps[0].tool == "proxy-lane-checker"
+
+
+def test_validate_custom_recipe() -> None:
+    recipe = WarmupRecipe.model_validate({"name": "custom", "steps": []})
+    assert recipe.name == "custom"