Skip to main content

repatch

Reusable HTML/CSS/DOM patch utilities extracted from Nexu Cinema: marked-element context, scope-restricted CSS, spatial deletes, LLM UI patch prompts, and local function DOM patches.

Also includes the original RepatchService for scope-based LLM fragment suggestions.

Install

pip install -e .
# Nexu: repatch @ file:///path/to/repatch in pyproject.toml

Local development (DevX)

Run the whole dev stack in one command — seed fixtures, hot-reload and interactive OpenAPI docs:

pip install -e ".[server]"   # once, to install fastapi + uvicorn
make dev                     # http://localhost:8000/docs

or via Docker Compose:

docker compose up --build   # or: make up

Both start a FastAPI dev server that exposes the patch utilities as HTTP endpoints, auto-generates OpenAPI docs at /docs (Swagger UI) and /redoc, and pre-loads the bundled seed fixtures (GET /seeds). make seed (or python -m repatch.seeds) lists the seed fixtures standalone. The server is started with --reload, so edits to repatch/ are picked up automatically.

Public API (repatch)

Module Key symbols
marked_context build_marked_element_context, resolve_marked_llm_context, restrict_scope_css_to_marks, marked_css_selectors, has_ui_marks
scope inject_scope_style, strip_scope_style, normalize_focus_scope, should_block_full_html_iterate, scoped_html_fragment
ui_patch build_ui_patch_prompt, parse_ui_patch_response, apply_ui_patch_options, supports_llm_patch_scope
spatial apply_spatial_deletes_to_html
dom_patch build_function_option_patches, build_function_patch_context, supports_function_patch
options sync_option_previews_from_workspace, enforce_deletes_on_option_previews, replace_html_title, html_files_distinct
css split_css_rules, validate_css_safety
project_ir build_project_ir, summarize_project_ir
service RepatchService, PatchSuggestion

Multi-Language Client SDKs

The repatch repository provides official client-side and process SDKs under the sdks/ directory to simplify surgical real-time UI mutations across different languages and platforms:

1. JavaScript SDK (sdks/js/repatch-sdk.js)

A client-side library to be included in browsers. It connects to the Repatch WebSocket/SSE stream and executes surgical updates:

  • ADD <selector> <html_content>: Appends child element.
  • REPLACE <selector> <html_content>: Replaces content.
  • STYLE <selector> { css }: Scopes CSS to element.
  • REMOVE <selector>: Deletes element.

2. Python Client SDK (sdks/python/repatch_sdk.py)

A thread-safe client that allows other python services, test harnesses, or CLI agents to subscribe or broadcast patches:

from repatch_sdk import RepatchClient

client = RepatchClient("ws://localhost:8083/repatch")

@client.on_patch
def handle_patch(data):
    print("Received patch DSL:", data["dsl"])

client.start()
client.send_patch("STYLE #btn-eq { background: red; }")

Example: marked context + UI patch prompt

from repatch import build_marked_element_context
from repatch.ui_patch import build_ui_patch_prompt

ctx = build_marked_element_context(html, keep_ids=["7"], delete_ids=["tan"], focus_scope="colors", project_kind="calculator")
prompt = build_ui_patch_prompt(html, focus_scope="colors", project_kind="calculator", option_variants=variants, context_fragment=ctx)

Example: file-level option previews

from repatch import enforce_deletes_on_option_previews, sync_option_previews_from_workspace

sync_option_previews_from_workspace(
    "capsule/cinema",
    stage=0,
    delete_ids=["old-cta"],
    finalize_html=my_finalize_html,
)

enforce_deletes_on_option_previews(
    "capsule/cinema",
    ["old-cta"],
    finalize_html=my_finalize_html,
)

Original RepatchService (v0)

from repatch import RepatchService

service = RepatchService(model="gpt-4o-mini")

fragment = """
<section>
  <h1>Pracownia Malort Gdynia – przestrzeń dla kreatywności Twojego dziecka</h1>
  <p>Zapraszamy do wyjątkowego miejsca...</p>

## AI Cost Tracking

![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.21-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.90-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-16.8h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)

- 🤖 **LLM usage:** $2.9005 (25 commits)
- 👤 **Human dev:** ~$1683 (16.8h @ $100/h, 30min dedup)

Generated on 2026-07-07 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)

---

  <button>Zapisz dziecko</button>
</section>
"""

suggestions = service.generate_patch_suggestions(
    fragment=fragment,
    scopes=["display", "colors"],
)

for idx, item in enumerate(suggestions, start=1):
    print(f"Wariant {idx}:")
    print("KEEP:", item.keep)
    print("CHANGE:", item.change)
    print(item.patched_fragment)

License

Licensed under Apache-2.0.

Metadata

Release files for repatch 0.2.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for repatch 0.2.21
File Size Uploaded Provenance Actions
repatch-0.2.21.tar.gz 75.8 kB Without provenance Details for repatch-0.2.21.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for repatch 0.2.21
File Interpreter ABI Platform Actions
repatch-0.2.21-py3-none-any.whl Python 3 none any Details for repatch-0.2.21-py3-none-any.whl

Total release size: 142.4 kB

Release files / repatch-0.2.21.tar.gz

Download URL repatch-0.2.21.tar.gz
Size 75.8 kB
Tags Source
SHA-256 checksum
How to use checksums
bf11764bee8e30a9cb327b51b0195418e7b60404184ed72715e02ca6ffe1a03f
BLAKE2b-256 checksum
How to use checksums
1f211b71b68db5e6970b8503eacfce9ddea3769f5ce61d48c8b974282a214fa1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / repatch-0.2.21-py3-none-any.whl

Download URL repatch-0.2.21-py3-none-any.whl
Size 66.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4410bb8ab17549075fa61cda926191bce878375c600d4c230c10521889ccace4
BLAKE2b-256 checksum
How to use checksums
5a33599c53ccefc767ed144f176d5a72e291feb025ffa7cd36b452adf82e4052
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Security for repatch 0.2.21

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page