kapi run

$ kapi run [flow-name] [flags]

Run a composed flow that chains multiple tools together.

Flows are multi-tool pipelines. For single-tool operations, use the tool directly (e.g. "kapi ai-translate" instead of "kapi run ai-translate").

Built-in flows: ai-translate-qa Translate + quality check using AI/LLM

Custom flows can be defined in .kapi project files or .bowrain/flows/ as YAML files.

Use -p to run a flow from a .kapi project file: kapi run translate -p myproject.kapi

Commandrun

Groupprocessing

Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

$ kapi run ai-translate-qa -i app.xliff --target-lang fr

Flags

Flag	Type	Default	Description
--api-key	string		API key for the AI provider
--concurrency, -j	int	0	number of files to process at once (0 = auto)
--credential	string		saved credential name to use (see 'kapi credentials list')
--encoding, -e	string	UTF-8	input file encoding
--explain	bool	false	print the resolved source → sink bindings and exit without running
--format, -f	string		override input format detection
--input, -i	stringSlice		input file path(s); repeat for multiple files
--model	string		AI model name
--output, -o	string		output path or template (e.g. ./out/{name}_{lang}.{ext})
--pack	bool	false	when transforming a .klz, also eject the result to the .klz (auto-pack)
--parallel-blocks	int	0	fan out block processing across N goroutines (0 = off)
--project, -p	string		path to a .kapi project recipe (auto-discovered from cwd if omitted)
--provider	string	anthropic	AI provider (anthropic, openai, ollama)
--source-lang	string	en	source language (e.g. en, en-US)
--stats	bool	false	include part/block counts in output
--target-lang	string		target language (e.g. fr, de-DE)
--termbase	string		named termbase for term-lookup/enforce (resolves from KAPI_HOME)
--tm	string		named TM for tm-leverage flow (resolves from KAPI_HOME)
--trace	string		write flow trace JSON to file (for flow visualization)

More examples

$ kapi run ai-translate-qa -i messages.json --target-lang de