comfy-cli 1.7.3__tar.gz → 1.9.0__tar.gz

{comfy_cli-1.7.3 → comfy_cli-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: comfy-cli
-Version: 1.7.3
+Version: 1.9.0
 Summary: A CLI tool for installing and using ComfyUI.
 Maintainer-email: Yoland Yan <yoland@drip.art>, James Kwon <hongilkwon316@gmail.com>, Robin Huang <robin@drip.art>, "Dr.Lt.Data" <dr.lt.data@gmail.com>
 License: GPL-3.0-only
@@ -52,11 +52,10 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/comfy-cli)](https://pypi.org/project/comfy-cli/)
 [![License](https://img.shields.io/pypi/l/comfy-cli)](https://github.com/Comfy-Org/comfy-cli/blob/main/LICENSE)
 
-comfy-cli is a command line tool that helps users easily install and manage
-[ComfyUI](https://github.com/comfyanonymous/ComfyUI), a powerful open-source
-machine learning framework. With comfy-cli, you can quickly set up ComfyUI,
-install packages, and manage custom nodes, all from the convenience of your
-terminal.
+comfy-cli is a command-line tool for installing, running, and extending
+[ComfyUI](https://github.com/comfyanonymous/ComfyUI) — the open-source
+generative-media engine. Set up ComfyUI, install custom nodes and models, run
+workflows, and call hosted partner image models, all from your terminal.
 
 ## Demo
 
@@ -64,29 +63,32 @@ terminal.
 
 ## Features
 
-- 🚀 Easy installation of ComfyUI with a single command
-- 📦 Seamless package management for ComfyUI extensions and dependencies
-- 🔧 Custom node management for extending ComfyUI's functionality
-- 🗄️ Download checkpoints and save model hash
-- 💻 Cross-platform compatibility (Windows, macOS, Linux)
-- 📖 Comprehensive documentation and examples
-- 🎉 install pull request to ComfyUI automatically
+- 🚀 One-command ComfyUI install and launch
+- 🎨 Direct calls to partner image and video nodes (Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, …) via `comfy generate`, no workflow JSON required
+- 🔧 Custom node management — install, update, snapshot, bisect
+- 📦 Fast dependency resolution with `uv` (`--fast-deps`, `--uv-compile`)
+- 🗄️ Model downloads from CivitAI, Hugging Face, and direct URLs
+- 🎬 Run workflows against a local ComfyUI server, including auto-conversion of UI-format JSON
+- 🧪 Test ComfyUI and frontend pull requests with one flag
+- 💻 Cross-platform: Windows, macOS, Linux
 
 ## Installation
 
-1. (Recommended, but not necessary) Enable virtual environment ([venv](https://docs.python.org/3/library/venv.html)/[conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html))
+1. (Recommended) Activate a virtual environment ([venv](https://docs.python.org/3/library/venv.html) or [conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html)).
 
-2. To install comfy-cli, make sure you have Python 3.9 or higher installed on your system. Then, run the following command:
+2. Install with `pip` (requires Python 3.10+):
 
-   `pip install comfy-cli`
+   ```bash
+   pip install comfy-cli
+   ```
 
 ### Shell Autocomplete
 
-To install autocompletion hints in your shell run:
+Install shell completion so `comfy <TAB>` expands commands and options:
 
-`comfy --install-completion`
-
-This enables you to type `comfy [TAP]` to autocomplete commands and options
+```bash
+comfy --install-completion
+```
 
 ## Usage
 
@@ -329,6 +331,57 @@ the bisect tool can help you pinpoint the custom node that causes the issue.
 
   `comfy model list ?[--relative-path <PATH>]`
 
+### Calling partner nodes (`comfy generate`)
+
+`comfy generate` calls Comfy's partner nodes directly from the terminal — no
+local ComfyUI or workflow JSON required. It hits the same hosted partner nodes
+you'd otherwise wire into a ComfyUI workflow, but as one-shot CLI calls. Image
+models (Flux, Ideogram, DALL·E, Recraft, Stability, Runway, Reve, xAI Grok, …)
+and video models (Kling, Luma, Runway Gen-3, Pika, Vidu, Moonvalley, Hailuo,
+Grok video) are all covered; video jobs run async and the CLI polls until the
+result is ready.
+
+Prerequisites — a Comfy API key and a credit balance:
+
+- [Create an API key](https://docs.comfy.org/development/comfyui-server/api-key-integration)
+- [Browse partner nodes and per-call credit costs](https://docs.comfy.org/tutorials/partner-nodes/overview) · [pricing table](https://docs.comfy.org/tutorials/partner-nodes/pricing)
+- [Add credits](https://docs.comfy.org/interface/credits)
+
+Set the key once, then go:
+
+```bash
+export COMFY_API_KEY=comfyui-...   # or pass --api-key on each call
+
+comfy generate list                                  # browse available models
+comfy generate schema flux-pro                       # see params for one model
+comfy generate flux-pro --prompt "a cat on the moon" \
+    --width 1024 --height 1024 --download cat.png
+```
+
+Reference images can be passed as local paths — the CLI uploads them through
+the cloud's storage endpoint (or base64-encodes inline, as each partner
+requires):
+
+```bash
+comfy generate flux-kontext --prompt "add a top hat" \
+    --input_image ./photo.jpg --download out.png
+
+comfy generate upload ./photo.jpg                    # explicit upload
+```
+
+Async models (every video model plus the Flux family) block until ready by
+default. Pass `--async` to return immediately with a job id, then resume later
+with `comfy generate resume <model> <job_id>`. Examples:
+
+```bash
+comfy generate kling --prompt "a paper boat drifting on a river at dusk" \
+    --duration 5 --download boat.mp4
+
+comfy generate luma --prompt "..." --aspect_ratio 16:9 --async
+# → prints job id; resume with:
+comfy generate resume luma <job_id> --download out.mp4
+```
+
 ### Managing ComfyUI-Manager
 
 - Disable ComfyUI-Manager completely (no manager flags passed to ComfyUI):
@@ -414,19 +467,19 @@ Check out the usage here: [Mixpanel Board](https://mixpanel.com/p/13hGfPfEPdRkjP
 
 ## Contributing
 
-We welcome contributions to comfy-cli! If you have any ideas, suggestions, or
-bug reports, please open an issue on our [GitHub
-repository](https://github.com/yoland68/comfy-cli/issues). If you'd like to contribute code,
-please fork the repository and submit a pull request.
+We welcome contributions to comfy-cli! For ideas, suggestions, or bug reports,
+open an issue at [Comfy-Org/comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues).
+For code changes, fork the repo and open a pull request.
 
-Check out the [Dev Guide](/DEV_README.md) for more details.
+See the [Dev Guide](/DEV_README.md) for setup details.
 
 ## License
 
-comfy is released under the [GNU General Public License v3.0](https://github.com/yoland68/comfy-cli/blob/master/LICENSE).
+Released under the [GNU General Public License v3.0](https://github.com/Comfy-Org/comfy-cli/blob/main/LICENSE).
 
 ## Support
 
-If you encounter any issues or have questions about comfy-cli, please [open an issue](https://github.com/comfy-cli/issues) on our GitHub repository or contact us on [Discord](https://discord.com/invite/comfyorg). We'll be happy to assist you!
+Questions or issues? [Open an issue](https://github.com/Comfy-Org/comfy-cli/issues)
+or reach us on [Discord](https://discord.com/invite/comfyorg).
 
 Happy diffusing with ComfyUI and comfy-cli! 🎉

{comfy_cli-1.7.3 → comfy_cli-1.9.0}/README.md

@@ -7,11 +7,10 @@
 [![Python](https://img.shields.io/pypi/pyversions/comfy-cli)](https://pypi.org/project/comfy-cli/)
 [![License](https://img.shields.io/pypi/l/comfy-cli)](https://github.com/Comfy-Org/comfy-cli/blob/main/LICENSE)
 
-comfy-cli is a command line tool that helps users easily install and manage
-[ComfyUI](https://github.com/comfyanonymous/ComfyUI), a powerful open-source
-machine learning framework. With comfy-cli, you can quickly set up ComfyUI,
-install packages, and manage custom nodes, all from the convenience of your
-terminal.
+comfy-cli is a command-line tool for installing, running, and extending
+[ComfyUI](https://github.com/comfyanonymous/ComfyUI) — the open-source
+generative-media engine. Set up ComfyUI, install custom nodes and models, run
+workflows, and call hosted partner image models, all from your terminal.
 
 ## Demo
 
@@ -19,29 +18,32 @@ terminal.
 
 ## Features
 
-- 🚀 Easy installation of ComfyUI with a single command
-- 📦 Seamless package management for ComfyUI extensions and dependencies
-- 🔧 Custom node management for extending ComfyUI's functionality
-- 🗄️ Download checkpoints and save model hash
-- 💻 Cross-platform compatibility (Windows, macOS, Linux)
-- 📖 Comprehensive documentation and examples
-- 🎉 install pull request to ComfyUI automatically
+- 🚀 One-command ComfyUI install and launch
+- 🎨 Direct calls to partner image and video nodes (Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, …) via `comfy generate`, no workflow JSON required
+- 🔧 Custom node management — install, update, snapshot, bisect
+- 📦 Fast dependency resolution with `uv` (`--fast-deps`, `--uv-compile`)
+- 🗄️ Model downloads from CivitAI, Hugging Face, and direct URLs
+- 🎬 Run workflows against a local ComfyUI server, including auto-conversion of UI-format JSON
+- 🧪 Test ComfyUI and frontend pull requests with one flag
+- 💻 Cross-platform: Windows, macOS, Linux
 
 ## Installation
 
-1. (Recommended, but not necessary) Enable virtual environment ([venv](https://docs.python.org/3/library/venv.html)/[conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html))
+1. (Recommended) Activate a virtual environment ([venv](https://docs.python.org/3/library/venv.html) or [conda](https://conda.io/projects/conda/en/latest/user-guide/getting-started.html)).
 
-2. To install comfy-cli, make sure you have Python 3.9 or higher installed on your system. Then, run the following command:
+2. Install with `pip` (requires Python 3.10+):
 
-   `pip install comfy-cli`
+   ```bash
+   pip install comfy-cli
+   ```
 
 ### Shell Autocomplete
 
-To install autocompletion hints in your shell run:
+Install shell completion so `comfy <TAB>` expands commands and options:
 
-`comfy --install-completion`
-
-This enables you to type `comfy [TAP]` to autocomplete commands and options
+```bash
+comfy --install-completion
+```
 
 ## Usage
 
@@ -284,6 +286,57 @@ the bisect tool can help you pinpoint the custom node that causes the issue.
 
   `comfy model list ?[--relative-path <PATH>]`
 
+### Calling partner nodes (`comfy generate`)
+
+`comfy generate` calls Comfy's partner nodes directly from the terminal — no
+local ComfyUI or workflow JSON required. It hits the same hosted partner nodes
+you'd otherwise wire into a ComfyUI workflow, but as one-shot CLI calls. Image
+models (Flux, Ideogram, DALL·E, Recraft, Stability, Runway, Reve, xAI Grok, …)
+and video models (Kling, Luma, Runway Gen-3, Pika, Vidu, Moonvalley, Hailuo,
+Grok video) are all covered; video jobs run async and the CLI polls until the
+result is ready.
+
+Prerequisites — a Comfy API key and a credit balance:
+
+- [Create an API key](https://docs.comfy.org/development/comfyui-server/api-key-integration)
+- [Browse partner nodes and per-call credit costs](https://docs.comfy.org/tutorials/partner-nodes/overview) · [pricing table](https://docs.comfy.org/tutorials/partner-nodes/pricing)
+- [Add credits](https://docs.comfy.org/interface/credits)
+
+Set the key once, then go:
+
+```bash
+export COMFY_API_KEY=comfyui-...   # or pass --api-key on each call
+
+comfy generate list                                  # browse available models
+comfy generate schema flux-pro                       # see params for one model
+comfy generate flux-pro --prompt "a cat on the moon" \
+    --width 1024 --height 1024 --download cat.png
+```
+
+Reference images can be passed as local paths — the CLI uploads them through
+the cloud's storage endpoint (or base64-encodes inline, as each partner
+requires):
+
+```bash
+comfy generate flux-kontext --prompt "add a top hat" \
+    --input_image ./photo.jpg --download out.png
+
+comfy generate upload ./photo.jpg                    # explicit upload
+```
+
+Async models (every video model plus the Flux family) block until ready by
+default. Pass `--async` to return immediately with a job id, then resume later
+with `comfy generate resume <model> <job_id>`. Examples:
+
+```bash
+comfy generate kling --prompt "a paper boat drifting on a river at dusk" \
+    --duration 5 --download boat.mp4
+
+comfy generate luma --prompt "..." --aspect_ratio 16:9 --async
+# → prints job id; resume with:
+comfy generate resume luma <job_id> --download out.mp4
+```
+
 ### Managing ComfyUI-Manager
 
 - Disable ComfyUI-Manager completely (no manager flags passed to ComfyUI):
@@ -369,19 +422,19 @@ Check out the usage here: [Mixpanel Board](https://mixpanel.com/p/13hGfPfEPdRkjP
 
 ## Contributing
 
-We welcome contributions to comfy-cli! If you have any ideas, suggestions, or
-bug reports, please open an issue on our [GitHub
-repository](https://github.com/yoland68/comfy-cli/issues). If you'd like to contribute code,
-please fork the repository and submit a pull request.
+We welcome contributions to comfy-cli! For ideas, suggestions, or bug reports,
+open an issue at [Comfy-Org/comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues).
+For code changes, fork the repo and open a pull request.
 
-Check out the [Dev Guide](/DEV_README.md) for more details.
+See the [Dev Guide](/DEV_README.md) for setup details.
 
 ## License
 
-comfy is released under the [GNU General Public License v3.0](https://github.com/yoland68/comfy-cli/blob/master/LICENSE).
+Released under the [GNU General Public License v3.0](https://github.com/Comfy-Org/comfy-cli/blob/main/LICENSE).
 
 ## Support
 
-If you encounter any issues or have questions about comfy-cli, please [open an issue](https://github.com/comfy-cli/issues) on our GitHub repository or contact us on [Discord](https://discord.com/invite/comfyorg). We'll be happy to assist you!
+Questions or issues? [Open an issue](https://github.com/Comfy-Org/comfy-cli/issues)
+or reach us on [Discord](https://discord.com/invite/comfyorg).
 
 Happy diffusing with ComfyUI and comfy-cli! 🎉

{comfy_cli-1.7.3 → comfy_cli-1.9.0}/comfy_cli/cmdline.py

@@ -11,6 +11,7 @@ from rich.console import Console
 
 from comfy_cli import constants, env_checker, logging, tracking, ui, utils
 from comfy_cli.command import code_search, custom_nodes, pr_command
+from comfy_cli.command import generate as generate_command
 from comfy_cli.command import install as install_inner
 from comfy_cli.command import run as run_inner
 from comfy_cli.command.install import validate_version
@@ -446,7 +447,23 @@ def run(
         int | None,
         typer.Option(help="The timeout in seconds for the workflow execution."),
     ] = 30,
+    api_key: Annotated[
+        str | None,
+        typer.Option(
+            "--api-key",
+            envvar="COMFY_API_KEY",
+            help=(
+                "Comfy API key for API Nodes (Partner Nodes). "
+                "Embedded in the prompt body as extra_data.api_key_comfy_org on POST /prompt. "
+                "For scripting, prefer the COMFY_API_KEY environment variable so the secret "
+                "stays out of shell history."
+            ),
+        ),
+    ] = None,
 ):
+    if api_key:
+        api_key = api_key.strip() or None
+
     config = ConfigManager()
 
     if host:
@@ -470,7 +487,7 @@ def run(
     if not port:
         port = 8188
 
-    run_inner.execute(workflow, host, port, wait, verbose, local_paths, timeout)
+    run_inner.execute(workflow, host, port, wait, verbose, local_paths, timeout, api_key=api_key)
 
 
 def validate_comfyui(_env_checker):
@@ -682,6 +699,7 @@ def standalone(
         sty.to_tarball()
 
 
+generate_command.register_with(app)
 app.add_typer(models_command.app, name="model", help="Manage models.")
 app.add_typer(custom_nodes.app, name="node", help="Manage custom nodes.")
 app.add_typer(custom_nodes.manager_app, name="manager", help="Manage ComfyUI-Manager.")

{comfy_cli-1.7.3 → comfy_cli-1.9.0}/comfy_cli/command/code_search.py

@@ -2,6 +2,7 @@
 
 import json
 import re
+import sys
 from typing import Annotated
 from urllib.parse import quote
 
@@ -20,12 +21,19 @@ DEFAULT_COUNT = 20
 REQUEST_TIMEOUT = 30
 
 
+_TYPE_FILTER_RE = re.compile(r"(^|\s)type:")
+
+
 def _build_query(query: str, repo: str | None, count: int) -> str:
     parts = []
     if repo:
         if "/" not in repo:
             repo = f"Comfy-Org/{repo}"
         parts.append(f"repo:^{re.escape(repo)}$")
+    # Only default to file matches when the user hasn't specified their own
+    # type: filter — otherwise respect whatever they passed (e.g. type:commit).
+    if not _TYPE_FILTER_RE.search(query):
+        parts.append("type:file")
     parts.append(f"count:{count}")
     parts.append(query)
     return " ".join(parts)
@@ -56,20 +64,21 @@ def _format_results(search: dict) -> list[dict]:
         commit_hash = (default_branch.get("target") or {}).get("commit", {}).get("oid", "")
         ref = commit_hash or branch_name
 
+        encoded_path = quote(file_path, safe="/")
+        file_url = f"https://github.com/{clean_name}/blob/{ref}/{encoded_path}"
+
         line_matches = result.get("lineMatches") or []
         matches = []
-        if line_matches:
-            encoded_path = quote(file_path, safe="/")
-            base_url = f"https://github.com/{clean_name}/blob/{ref}/{encoded_path}"
-            for m in line_matches:
-                line = m.get("lineNumber", 0) + 1
-                preview = m.get("preview", "").rstrip()
-                matches.append({"line": line, "preview": preview, "url": f"{base_url}#L{line}"})
+        for m in line_matches:
+            line = m.get("lineNumber", 0) + 1
+            preview = m.get("preview", "").rstrip()
+            matches.append({"line": line, "preview": preview, "url": f"{file_url}#L{line}"})
 
         formatted.append(
             {
                 "repository": clean_name,
                 "file": file_path,
+                "file_url": file_url,
                 "branch": branch_name,
                 "commit": commit_hash,
                 "matches": matches,
@@ -96,19 +105,34 @@ def _print_results(results: list[dict], stats: dict, json_output: bool) -> None:
         console.print("[yellow]No results found.[/yellow]")
         return
 
+    # Use raw isatty() rather than Rich's console.is_terminal: Rich treats
+    # FORCE_COLOR=1 / TTY_COMPATIBLE=1 as terminal-capable even when stdout
+    # is redirected, but OSC 8 escapes in a piped stream defeat the whole
+    # point of this branch (hiding URLs from humans, exposing them to AI).
+    is_tty = sys.stdout.isatty()
+
     for file_result in results:
+        repo = file_result["repository"]
+        path = file_result["file"]
+        file_url = file_result["file_url"]
+
         header = Text()
-        header.append(file_result["repository"], style="bold cyan")
-        header.append(" / ", style="dim")
-        header.append(file_result["file"], style="bold")
+        if is_tty:
+            # Humans: clickable OSC 8 hyperlink, URL hidden from visible output.
+            header.append(f"{repo} / {path}", style=f"bold cyan link {file_url}")
+        else:
+            # Non-TTY (pipes, AI agents): print the raw URL once per file so
+            # agents can synthesize #L<line> anchors themselves.
+            header.append(f"{repo} / {path}\n")
+            header.append(f"  {file_url}", style="dim")
         console.print(header)
 
         for match in file_result["matches"]:
-            line_text = Text()
-            line_text.append(f"  L{match['line']:>5}", style="green")
+            line_text = Text("  ")
+            line_style = f"green link {match['url']}" if is_tty else "green"
+            line_text.append(f"L{match['line']:>5}", style=line_style)
             line_text.append(f"  {match['preview']}")
             console.print(line_text)
-            console.print(f"        [dim]{match['url']}[/dim]")
 
         console.print()
 
@@ -121,7 +145,15 @@ def _print_results(results: list[dict], stats: dict, json_output: bool) -> None:
 @app.callback(invoke_without_command=True)
 @tracking.track_command()
 def code_search(
-    query: Annotated[str, typer.Argument(help="Search query (supports Sourcegraph syntax)")],
+    query: Annotated[
+        str,
+        typer.Argument(
+            help=(
+                "Search query (supports Sourcegraph syntax). Defaults to file matches; "
+                "pass your own `type:` filter (e.g. `type:commit`) to override."
+            ),
+        ),
+    ],
     repo: Annotated[
         str | None,
         typer.Option("--repo", "-r", help="Filter by repository (e.g. ComfyUI, Comfy-Org/ComfyUI)"),

{comfy_cli-1.7.3 → comfy_cli-1.9.0}/comfy_cli/command/custom_nodes/command.py

@@ -975,6 +975,17 @@ def validate_node_for_publishing():
     # Perform some validation logic here
     typer.echo("Validating node configuration...")
     config = extract_node_configuration()
+    if config is None:
+        raise typer.Exit(code=1)
+
+    if not config.project.version:
+        # Escape `[` chars so rich doesn't parse `[tool.comfy.version]` and
+        # `["version"]` as markup tags; `]` doesn't need escaping.
+        print(
+            "[red]Error: project version is empty. Set `project.version` in pyproject.toml, "
+            r'or configure `\[tool.comfy.version].path` if using `dynamic = \["version"]`.[/red]'
+        )
+        raise typer.Exit(code=1)
 
     # Run security checks first
     typer.echo("Running security checks...")

comfy_cli-1.9.0/comfy_cli/command/generate/__init__.py

@@ -0,0 +1,3 @@
+from comfy_cli.command.generate.app import register_with
+
+__all__ = ["register_with"]