Installation¶
Requirements¶
- Python 3.11 or newer
- The Vexy Lines desktop app for MCP and export commands
- macOS for the dialog-less export pipeline (uses AppleScript and
defaults write)
Install from PyPI¶
pip install vexy-lines-cli
This pulls in vexy-lines-apy (MCP client, style engine) and vexy-lines-py (parser) automatically.
Or with uv:
uv add vexy-lines-cli
Additional packages¶
For video processing and the GUI, install the companion app:
pip install vexy-lines-run
Video dependencies (PyAV, OpenCV, resvg-py) are included in the base vexy-lines-run install.
Installed commands¶
| Command | What it runs |
|---|---|
vexy-lines-cli |
CLI interface |
vexy-lines-mcp |
MCP stdio-to-TCP bridge server |
Runtime dependencies¶
| Package | Why |
|---|---|
vexy-lines-apy |
MCP client and style engine |
fire |
CLI framework (subcommand dispatch) |
loguru |
Structured debug logging |
Verify the install¶
vexy-lines-cli --help
Development install¶
git clone https://github.com/vexyart/vexy-lines.git
cd vexy-lines/vexy-lines-cli
uv venv --python 3.12
uv pip install -e ".[dev]"
Run tests:
uvx hatch test