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.
pip install -e . # Nexu: repatch @ file:///path/to/repatch in pyproject.toml
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 upBoth 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.
| 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 |
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:
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.
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; }")
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)
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, )
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)
Licensed under Apache-2.0.