vexy-lines-apy¶

Python bindings to the Vexy Lines MCP API and style engine.

Connect to the Vexy Lines app over TCP, drive it programmatically, and transfer artistic styles between images, all from Python.

Three entry points¶

MCPClient: a context-managed TCP client that speaks JSON-RPC 2.0 to the Vexy Lines embedded server. Open documents, manipulate layers, change fill parameters, render, export. If the app isn't running, the client launches it.

Style engine: extract a fill style from a .lines file, apply it to any source image, or blend two styles at any mix ratio. No GUI interaction needed.

JobFolder: persistent intermediate storage for resumable export pipelines. Stores .lines, .svg, and frame artifacts alongside the final output instead of in temp directories.

Quick start: MCP client¶

from vexy_lines_api import MCPClient

with MCPClient() as vl:
    vl.open_document("photo.lines")
    info = vl.get_document_info()
    print(f"{info.width_mm:.0f} x {info.height_mm:.0f} mm @ {info.resolution} dpi")

    tree = vl.get_layer_tree()    # LayerNode tree
    vl.render()                    # render + wait for completion
    vl.export_svg("output.svg")

Quick start: style transfer¶

from vexy_lines_api import MCPClient, extract_style, apply_style

style = extract_style("reference.lines")

with MCPClient() as vl:
    svg = apply_style(vl, style, "photo.jpg", dpi=72)

with open("result.svg", "w") as f:
    f.write(svg)

Quick start: style interpolation¶

from vexy_lines_api import extract_style, interpolate_style

a = extract_style("painterly.lines")
b = extract_style("technical.lines")
mid = interpolate_style(a, b, t=0.5)   # halfway between both

Quick start: resumable batch export¶

from vexy_lines_api.export import JobFolder, ExportRequest, process_export

request = ExportRequest(
    mode="images",
    input_paths=["photo1.jpg", "photo2.jpg"],
    style_path="artistic.lines",
    end_style_path=None,
    output_path="./output/",
    format="SVG",
    size="1x",
)

process_export(request, on_progress=lambda cur, total, msg: print(f"[{cur}/{total}] {msg}"))

Next steps¶

Installation: install options, dependencies, and optional extras
API Reference: every class, method, function, and constant
AI Rename: describe each fill with a vision model and rename layers & fills
Style Engine: how extraction, application, interpolation, and relative scaling work
MCP Protocol: the 25 tools in 5 groups, wire format, parameter reference, bridge setup
Examples: real-world usage patterns including batch processing, video, and error handling