runcomfy-cli

Name: runcomfy-cli
Author: prime-skills

31stars9forks

How to install runcomfy-cli?

prime-skills/runcomfy-agent-skills/runcomfy-cli

$npx -y skills add prime-skills/runcomfy-agent-skills --skill runcomfy-cli

Installs into the current project.

Summary

Run any model on RunComfy from the command line. The runcomfy CLI is one binary, one auth, hundreds of model endpoints — image generation, image edit, video generation, image-to-video, lip-sync, face swap, video edit, inpainting, outpainting, extend, ControlNet, relight, upscal

Files · 1

View on GitHub

SKILL.md

1	# RunComfy CLI
2
3	One binary, one auth, every RunComfy model. Install once, sign in once, then call any text-to-image, video, edit, lip-sync, face-swap, or LoRA-training endpoint with `runcomfy run <model_id> --input '{...}'`. This skill is the foundation every other `runcomfy-*` skill builds on.
4
5	[runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [CLI docs](https://docs.runcomfy.com/cli/introduction?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [All models](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli)
6
7	## Install this skill
8
9	```bash
10	npx skills add agentspace-so/runcomfy-agent-skills --skill runcomfy-cli -g
11	```
12
13	## Install the CLI
14
15	Pick one:
16
17	```bash
18	# Global install via npm (recommended for repeat use)
19	npm i -g @runcomfy/cli
20
21	# Zero-install one-shot (no Node global state)
22	npx -y @runcomfy/cli --version
23	```
24
25	A standalone curl-pipe installer also exists for environments without Node — see [docs.runcomfy.com/cli/install](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli). Inspect any install script before piping it into a shell. This skill only invokes the CLI via `Bash(runcomfy *)` after you have installed it through one of the verified package managers above.
26
27	Confirm:
28
29	```bash
30	runcomfy --version
31	```
32
33	Full options on the [Install page](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
34
35	## Sign in
36
37	Interactive (opens browser):
38
39	```bash
40	runcomfy login
41	# Code shown in terminal — paste into the browser page, click Authorize
42	# Token saved to ~/.config/runcomfy/token.json with mode 0600
43	```
44
45	CI / containers (no browser):
46
47	```bash
48	export RUNCOMFY_TOKEN=<token-from-runcomfy.com/profile>
49	```
50
51	Verify:
52
53	```bash
54	runcomfy whoami
55	# 📛 you@example.com
56	# token type: cli
57	# user id: ...
58	```
59
60	Full flow + token rotation: [Authentication](https://docs.runcomfy.com/cli/auth?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
61
62	## Run a model
63
64	The general shape:
65
66	```bash
67	runcomfy run <vendor>/<model>/<endpoint> \
68	--input '<JSON body>' \
69	--output-dir <path>
70	```
71
72	Example — generate an image with GPT Image 2:
73
74	```bash
75	runcomfy run openai/gpt-image-2/text-to-image \
76	--input '{"prompt": "a small purple cat at sunset, photorealistic"}'
77	```
78
79	You will see:
80
81	```
82	⏳ Submitting request to openai/gpt-image-2/text-to-image
83	request_id: 8a3f...
84	⏳ Polling status (every 2s)...
85	in_queue
86	in_progress
87	completed
88	✅ completed
89	{
90	"images": [
91	"https://playgrounds-storage-public.runcomfy.net/.../result.png"
92	]
93	}
94	📥 Downloading 1 file(s) to .
95	./result.png
96	```
97
98	By default the result is downloaded to the current directory. Override with `--output-dir ./out`, skip downloading with `--no-download`.
99
100	Quickstart: [docs.runcomfy.com/cli/quickstart](https://docs.runcomfy.com/cli/quickstart?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
101
102	## Discover model schemas
103
104	Every model has an `API` tab on its detail page with the exact input schema. Browse the catalog:
105
106	```bash
107	open https://www.runcomfy.com/models
108	```
109
110	Or search by collection / capability:
111
112	\| URL \| What \|
113	\|---\|---\|
114	\| [`/models`](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| All featured models \|
115	\| [`/models/all`](https://www.runcomfy.com/models/all?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| The full catalog \|
116	\| [`/models/collections/recently-added`](https://www.runcomfy.com/models/collections/recently-added?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| Fresh additions \|
117	\| [`/models/collections/nano-banana`](https://www.runcomfy.com/models/collections/nano-banana?utm_source=skills.sh&utm_medium=skill&utm_campaign

People who liked this also viewed

6 picks

Type

runcomfy-cli

31stars9forks

View on GitHub

How to install runcomfy-cli?

prime-skills/runcomfy-agent-skills/runcomfy-cli

$npx -y skills add prime-skills/runcomfy-agent-skills --skill runcomfy-cli

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# RunComfy CLI
2
3	One binary, one auth, every RunComfy model. Install once, sign in once, then call any text-to-image, video, edit, lip-sync, face-swap, or LoRA-training endpoint with `runcomfy run <model_id> --input '{...}'`. This skill is the foundation every other `runcomfy-*` skill builds on.
4
5	[runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [CLI docs](https://docs.runcomfy.com/cli/introduction?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [All models](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli)
6
7	## Install this skill
8
9	```bash
10	npx skills add agentspace-so/runcomfy-agent-skills --skill runcomfy-cli -g
11	```
12
13	## Install the CLI
14
15	Pick one:
16
17	```bash
18	# Global install via npm (recommended for repeat use)
19	npm i -g @runcomfy/cli
20
21	# Zero-install one-shot (no Node global state)
22	npx -y @runcomfy/cli --version
23	```
24
25	A standalone curl-pipe installer also exists for environments without Node — see [docs.runcomfy.com/cli/install](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli). Inspect any install script before piping it into a shell. This skill only invokes the CLI via `Bash(runcomfy *)` after you have installed it through one of the verified package managers above.
26
27	Confirm:
28
29	```bash
30	runcomfy --version
31	```
32
33	Full options on the [Install page](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
34
35	## Sign in
36
37	Interactive (opens browser):
38
39	```bash
40	runcomfy login
41	# Code shown in terminal — paste into the browser page, click Authorize
42	# Token saved to ~/.config/runcomfy/token.json with mode 0600
43	```
44
45	CI / containers (no browser):
46
47	```bash
48	export RUNCOMFY_TOKEN=<token-from-runcomfy.com/profile>
49	```
50
51	Verify:
52
53	```bash
54	runcomfy whoami
55	# 📛 you@example.com
56	# token type: cli
57	# user id: ...
58	```
59
60	Full flow + token rotation: [Authentication](https://docs.runcomfy.com/cli/auth?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
61
62	## Run a model
63
64	The general shape:
65
66	```bash
67	runcomfy run <vendor>/<model>/<endpoint> \
68	--input '<JSON body>' \
69	--output-dir <path>
70	```
71
72	Example — generate an image with GPT Image 2:
73
74	```bash
75	runcomfy run openai/gpt-image-2/text-to-image \
76	--input '{"prompt": "a small purple cat at sunset, photorealistic"}'
77	```
78
79	You will see:
80
81	```
82	⏳ Submitting request to openai/gpt-image-2/text-to-image
83	request_id: 8a3f...
84	⏳ Polling status (every 2s)...
85	in_queue
86	in_progress
87	completed
88	✅ completed
89	{
90	"images": [
91	"https://playgrounds-storage-public.runcomfy.net/.../result.png"
92	]
93	}
94	📥 Downloading 1 file(s) to .
95	./result.png
96	```
97
98	By default the result is downloaded to the current directory. Override with `--output-dir ./out`, skip downloading with `--no-download`.
99
100	Quickstart: [docs.runcomfy.com/cli/quickstart](https://docs.runcomfy.com/cli/quickstart?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).
101
102	## Discover model schemas
103
104	Every model has an `API` tab on its detail page with the exact input schema. Browse the catalog:
105
106	```bash
107	open https://www.runcomfy.com/models
108	```
109
110	Or search by collection / capability:
111
112	\| URL \| What \|
113	\|---\|---\|
114	\| [`/models`](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| All featured models \|
115	\| [`/models/all`](https://www.runcomfy.com/models/all?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| The full catalog \|
116	\| [`/models/collections/recently-added`](https://www.runcomfy.com/models/collections/recently-added?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) \| Fresh additions \|
117	\| [`/models/collections/nano-banana`](https://www.runcomfy.com/models/collections/nano-banana?utm_source=skills.sh&utm_medium=skill&utm_campaign

People who liked this also viewed

6 picks

Type