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
   
  
- 🤖 **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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.