mlx-warmup-kit 0.1.0__py3-none-any.whl

mlx_warmup_kit/__init__.py

@@ -0,0 +1,3 @@
+"""MLX browser warmup pipeline planner."""
+
+__version__ = "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/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/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/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,10 @@
+mlx_warmup_kit/__init__.py,sha256=Q5F4jwo1Iu9lf63MfuxFVsZF2mkGDN7zamnKWjCmOH4,66
+mlx_warmup_kit/cli.py,sha256=lgXTDzCahwoUSr_olWRk-TW3uX0Vkx8uJeC-cXnAfHs,2648
+mlx_warmup_kit/deal.py,sha256=1Sivqqk_K8jmY0wYk9OqCSx4pD0BmpQ9sGpHMlRtxqY,845
+mlx_warmup_kit/plan.py,sha256=uvp2xr3u4gltvLwzSOfJbB8SBeFcLg7U4Bg82Gs1fKc,1184
+mlx_warmup_kit/recipe.py,sha256=frj34mtFsxGzoyJYuYA0J0yTaQQuSdA_brftdjLqTho,1597
+mlx_warmup_kit-0.1.0.dist-info/METADATA,sha256=ol46tPoSe4IJ6HO5pdcGhRMUm3xUz9jOcyT5iSQH-ig,5736
+mlx_warmup_kit-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+mlx_warmup_kit-0.1.0.dist-info/entry_points.txt,sha256=VoQ_qbIYGJ8OOWTA_rnnJUhATWyt9xhMYuShkxvITRY,55
+mlx_warmup_kit-0.1.0.dist-info/licenses/LICENSE,sha256=yBby87TZyU-zAyZx2QxLX9jQFl-OvZ3HtZoEptvYEJY,1089
+mlx_warmup_kit-0.1.0.dist-info/RECORD,,

mlx_warmup_kit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

mlx_warmup_kit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mlx-warmup = mlx_warmup_kit.cli:main

mlx_warmup_kit-0.1.0.dist-info/licenses/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.