langchain-ilovevideoeditor

Render MP4 videos from your LangChain agents with the iLoveVideoEditor cloud rendering API.

The package exposes ILoveVideoEditorTool, a LangChain tool that takes a VideoJSON specification, queues a cloud render, and returns the finished video's download URL.

Installation

pip install -U langchain-ilovevideoeditor

Set your API key (get one from the dashboard):

export ILOVEVIDEOEDITOR_API_KEY="vf_live_..."

Usage

from langchain_ilovevideoeditor import ILoveVideoEditorTool

tool = ILoveVideoEditorTool()

result = tool.invoke({
    "video_json": {
        "name": "hello",
        "layers": [
            {
                "type": "text",
                "settings": {
                    "startTime": 0,
                    "duration": 3,
                    "text": "Hello from LangChain",
                    "fontSize": 64,
                    "color": "#ffffff",
                },
            }
        ],
    }
})
# '{"jobId": "425ba18a-...", "status": "completed", "downloadUrl": "https://..."}'

Queue without waiting for the render to finish:

result = tool.invoke({
    "video_json": video_json,
    "wait_for_completion": False,
})
# '{"jobId": "425ba18a-...", "status": "queued"}'

With an agent

from langchain_ilovevideoeditor import ILoveVideoEditorTool

tools = [ILoveVideoEditorTool()]
# pass `tools` to your agent / model.bind_tools(...)

Configuration

Development

uv sync --group test --group lint
uv run pytest tests/unit_tests
uv run ruff check langchain_ilovevideoeditor tests

Integration tests hit the real API and are skipped unless ILOVEVIDEOEDITOR_API_KEY is set:

ILOVEVIDEOEDITOR_API_KEY=vf_live_... uv run pytest tests/integration_tests

License

MIT