Integrations
All the clients are free; checks are paid from your credit.
Python SDK
pip install raccord-sdk
| Call | Does |
|---|---|
Raccord(api_key=None, base_url=None) |
Reads RACCORD_API_KEY if no key is given. |
check(clip, references=None, costumes=None, size=None, fps=None, label=None) |
One take. references maps names to photo files or folders. |
rank(clips, references=None) |
Order several takes; .result["top_two"]. |
keyframe_gate(image, references=None, costumes=None, size=None) |
A start frame. |
preflight(prompt, references=None, costumes=None) |
A prompt and its photos. |
check_extension(previous, segment, references=None) |
An extension and its join. |
preview(frames, progress, references=None) |
Early abort: .result["stop"]. |
until_pass(render, max_takes, references=None) |
Call render(n) until a take passes. |
get(id), wait(id), list(), usage(), verify(check) |
Reading, and signature checks. |
Each returns a Check with .status, .passed, .headline, .findings, .result, .cost (the display string, e.g. "$0.04") and .data (the full object, where cost has usd too). Errors raise RaccordError with .status, .type, .message and .fix.
MCP server, for AI agents
Lets Claude, Cursor or any MCP client check takes. It runs on the machine that has the files.
{"mcpServers": {"raccord": {"command": "raccord-mcp", "env": {"RACCORD_API_KEY": "rk_live_..."}}}}
| Tool | Does |
|---|---|
check |
Checks a take. |
rank |
Ranks several takes. |
keyframe_gate |
Checks a start frame. |
preflight |
Checks a prompt and its photos. |
get_verdict |
Fetches an earlier check. |
usage |
Credit and spend. |
The server tells the agent how to use them: pre-flight, then gate the start frame, check each take, act on each fix, and stop once a take passes. Install it with pip install "raccord-sdk[mcp]".
Watch folder
Every take that lands in a folder is checked and appears on your review screen.
raccord-watch ~/Renders --ref Maya=refs/maya/ --wardrobe Maya=costumes/maya_sc12/
- A file is checked once it stops growing.
- Checked files are remembered in
.raccord-watch.json, so restarts never re-check or re-charge.
ComfyUI
Copy raccord_comfyui into ComfyUI/custom_nodes/ and run pip install raccord-sdk in ComfyUI's Python.
| Node | Does |
|---|---|
| Raccord Check | Takes frames (IMAGE) and fps, plus an optional reference image. Outputs passed, verdict and a text report. Wire passed into a switch to keep only good takes. |
| Raccord Keyframe Gate | Checks a start frame before it's animated. |
| Raccord KSampler (early abort) | A KSampler that stops a render partway when it's clearly doomed. |
Review screen
At app.kolamlabs.ai, every check, from any source, lands in one inbox.
| Key | Does |
|---|---|
| J / L | Previous / next take |
| A | Approve |
| R | Reject |
| E | Escalate |