Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions es/agent-tools/cli.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,17 @@ title: "Comfy CLI: ejecuta ComfyUI desde la terminal"
description: "Controla Comfy desde la terminal: ComfyUI local, llamadas de generación de socios y flujos de trabajo completos en Comfy Cloud. Complementa MCP para scripts, CI y automatización."
sidebarTitle: "Comfy CLI"
icon: "terminal"
translationSourceHash: 99bc3bd2
translationSourceHash: bc3e7c14
translationFrom: agent-tools/cli.mdx
translationBlockHashes:
"_intro": cb162cdd
"How it fits with MCP": a452f8fb
"What the CLI does": 3c8cfc5f
"Install and set up": 4c281b95
"Prerequisites for `comfy generate`": 66aa291a
"Your first generation": b4f2ff1a
"Available models": 7275a9fe
"Usage examples": f6768bfe
"Beyond `comfy generate`": 8e75f6a8
"Agent skills": 5cfcfe55
"Related resources": d4e97516
Expand All @@ -38,14 +40,14 @@ import GenerateVideoAsync from "/snippets/es/comfy-cli/generate-video-async.mdx"

<GenerateBetaInfo/>

## Cómo encaja con MCP
## Cómo se integra con MCP

| | Comfy MCP (cloud) | Comfy CLI |
|---|---|---|
| **Interfaz** | Chat con un cliente MCP (Claude Code, Claude Desktop, …) | Comandos de terminal y scripts |
| **Ideal para** | Flujos de trabajo interactivos con agentes en el chat | Automatización, ejecuciones por lote, CI, canalizaciones de shell |
| **Autenticación** | OAuth en clientes MCP, o clave API (sin interfaz) | `comfy cloud login` (OAuth) o clave API (CI) |
| **Salida** | Devuelta en la sesión de chat | Guardada en disco (`--download`) o en JSON (`--json`) |
| **Salida** | Se devuelve en la sesión de chat | Se guarda en disco (`--download`) o en JSON (`--json`) |

Para la configuración de MCP, la instalación, las listas de herramientas y los métodos de autenticación, consulta [Comfy MCP](/es/agent-tools/mcp).

Expand All @@ -65,15 +67,14 @@ Para la configuración de MCP, la instalación, las listas de herramientas y los
comfy setup
```

Pasa `-y` para instalaciones no interactivas en CI o scripts. Consulta [Primeros pasos con Comfy CLI](/es/comfy-cli/getting-started#configuración-rápida-recomendado) para ver la tabla completa de flags de `comfy setup`.
Usa `-y` para instalaciones no interactivas en CI o scripts. Consulta [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started#configuración-rápida-recomendado) para ver la tabla completa de opciones de `comfy setup`.

Inicia sesión en Comfy Cloud:

```bash
comfy cloud login
comfy cloud whoami
```

## Requisitos previos para `comfy generate`

<GeneratePrerequisites/>
Expand All @@ -84,7 +85,7 @@ comfy cloud whoami

## Modelos disponibles

`comfy generate` abarca modelos de socios para imagen y video. Descubre qué hay disponible en tu versión de la CLI:
`comfy generate` cubre modelos de socios para imagen y video. Descubre qué hay disponible en tu versión de CLI:

```bash
comfy generate list # todos los modelos
Expand Down Expand Up @@ -127,15 +128,14 @@ comfy generate nano-banana \
```bash
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
```

## Más allá de `comfy generate`

Todo lo anterior es el resumen enfocado en agentes. La guía completa recorre cada comando en profundidad:

- `comfy run`, `comfy jobs` y `comfy validate` para flujos de trabajo completos
- `comfy templates` y la edición de slots de `comfy workflow`
- Descubrimiento con `comfy nodes` / `comfy models`
- Sobres `--json` y `comfy --json discover` para agentes
- Edición de slots con `comfy templates` y `comfy workflow`
- Descubrimiento de `comfy nodes` / `comfy models`
- Sobres JSON de `--json` y `comfy --json discover` para agentes

→ [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started) (documentación completa)

Expand All @@ -147,12 +147,12 @@ Todo lo anterior es el resumen enfocado en agentes. La guía completa recorre ca

| Recurso | Para qué sirve |
|---|---|
| [Primeros pasos con Comfy CLI](/es/comfy-cli/getting-started) | Guía de instalación **completa** y recorrido por los comandos |
| [Primeros pasos de Comfy CLI](/es/comfy-cli/getting-started) | Guía de instalación **completa** y recorrido por los comandos |
| [Referencia de Comfy CLI](/es/comfy-cli/reference) | Comandos, flags y alias de modelos |
| [Comfy MCP](/es/agent-tools/mcp) | Conecta agentes mediante MCP para generar desde el chat |
| [comfy-cli en GitHub](https://github.com/Comfy-Org/comfy-cli) | Repositorio fuente, problemas y el comportamiento más reciente |
| [comfy-cli en GitHub](https://github.com/Comfy-Org/comfy-cli) | Repositorio fuente, problemas y comportamiento más reciente |

## Retroalimentación

- **GitHub**: [problemas de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues)
- **GitHub**: [Problemas de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues)
- **Discord**: [#comfy-mcp-and-cli](https://discord.gg/xWJn6nhE3R)
64 changes: 32 additions & 32 deletions es/comfy-cli/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,25 @@
title: "Empezar con Comfy CLI"
sidebarTitle: "Empezar"
description: "Instala comfy-cli, configura el enrutamiento local o en la nube, genera con Nodos asociados y ejecuta flujos de trabajo desde la terminal."
translationSourceHash: b900dd1f
translationSourceHash: 843f41c2
translationFrom: comfy-cli/getting-started.mdx
translationBlockHashes:
"_intro": fe779f6e
"Overview": ff0c2f27
"Install CLI": ba7f2317
"Quick Setup (Recommended)": d38c5eb6
"Install ComfyUI (Local)": fd282ff2
"Run ComfyUI (Local)": 962395ce
"Comfy Cloud": 50dc06e8
"Generate with Partner Nodes": c1ee8203
"Run Workflows {#comfy run}": 653c16e1
"Start from a Template": 0a2858ac
"Edit Workflows In Place": 29dc5cfc
"Discover Nodes and Models": 1e48149f
"Upload and Download Files": 683ee497
"Manage Custom Nodes": 7498a89e
"Manage Models (Local)": cad0a47b
"JSON Output for Scripts and Agents": c0089a69
"Agent Skills": e16537cf
"Contributing": 2ca91c9b
"Analytics": 8ee20c3e
Expand All @@ -41,7 +46,7 @@ import GenerateVideoAsync from "/snippets/es/comfy-cli/generate-video-async.mdx"

Cumple tres funciones principales:

1. **Administrar una instalación local de ComfyUI**: instalar, iniciar, actualizar, crear instantáneas y bisecar ComfyUI y los Nodos personalizados.
1. **Administrar una instalación local de ComfyUI**: instalar, iniciar, actualizar, crear instantáneas y bisecar ComfyUI y los Nodos Personalizados.
2. **Acceder a los Nodos asociados alojados**: generar imágenes, video, audio y 3D con proveedores como Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley y otros, con un solo comando.
3. **Ejecutar flujos de trabajo completos en Comfy Cloud**: enviar grafos de flujo de trabajo, explorar la galería de plantillas seleccionadas, editar los slots de los flujos de trabajo y seguir las tareas hasta que terminen, sin necesidad de una GPU local.

Expand Down Expand Up @@ -78,7 +83,6 @@ Comprueba qué espacio de trabajo está seleccionado y qué está instalado:
comfy which
comfy env
```

## Comfy Cloud

<CloudAuth/>
Expand All @@ -87,7 +91,7 @@ comfy env

<GenerateBetaInfo/>

La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-nodes/overview) de Comfy desde una terminal o un script. Usa los mismos endpoints alojados que los flujos de trabajo de ComfyUI, pero como llamadas individuales de la CLI. Es ideal para trabajos por lotes, experimentos rápidos y automatización donde un gráfico completo de ComfyUI no es necesario.
La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-nodes/overview) de Comfy desde una terminal o un script. Usa los mismos endpoints alojados que los flujos de trabajo de ComfyUI, pero como llamadas individuales de CLI. Es ideal para trabajos por lote, experimentos rápidos y automatización donde no hace falta un gráfico completo de ComfyUI.

### Requisitos previos

Expand All @@ -98,7 +102,7 @@ La forma más rápida de llamar a los [nodos asociados](/es/tutorials/partner-no
<GenerateFirstCall/>

<Tip>
Descubre primero los parámetros reales de un modelo. Los nombres de las flags varían según el modelo (por ejemplo, `flux-ultra` acepta `--width`/`--height`; `seedance` acepta `--ratio`/`--resolution`/`--duration`). Verifica siempre antes de crear un script:
Descubre primero los parámetros reales de un modelo. Los nombres de los flags varían según el modelo (por ejemplo, `flux-ultra` usa `--width`/`--height`; `seedance` usa `--ratio`/`--resolution`/`--duration`). Verifica siempre antes de escribir un script:

```bash
comfy generate schema flux-ultra
Expand Down Expand Up @@ -130,7 +134,7 @@ comfy generate schema flux-kontext # ver los parámetros de un model

### Salida JSON para scripts

Emite las respuestas sin procesar de la API para integrarlas en pipelines:
Emite respuestas sin procesar de la API para integrarlas en tu pipeline:

```bash
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
Expand All @@ -140,14 +144,14 @@ Consulta la [referencia](/es/comfy-cli/reference) para ver la lista completa de

## Ejecutar flujos de trabajo {#comfy run}

Más allá de las llamadas individuales a socios, `comfy run` envía un gráfico de flujo de trabajo completo de ComfyUI. Acepta JSON tanto en formato API como en formato UI exportado (los flujos de trabajo de UI se convierten a formato API en el lado del cliente) y enruta a local o a la nube como cualquier otro comando. Es **asíncrono de forma predeterminada**. Devuelve un `prompt_id` en milisegundos mientras un proceso de vigilancia en segundo plano sigue el progreso. Usa `--wait` si prefieres bloquear.
Más allá de las llamadas individuales a socios, `comfy run` envía un gráfico de flujo de trabajo completo de ComfyUI. Acepta JSON en formato API y JSON exportado en formato UI (los flujos de trabajo de UI se convierten a formato API en el lado del cliente), y se dirige a local o a la nube como cualquier otro comando. Es **asíncrono por defecto**. Devuelve un `prompt_id` en milisegundos mientras un vigilante en segundo plano hace seguimiento del progreso. Pasa `--wait` para bloquear en su lugar.

```bash
# Envía; devuelve de inmediato un prompt_id
# Envía; devuelve de inmediato con un prompt_id
RES=$(comfy --json run --workflow my_workflow.json)
PROMPT_ID=$(echo "$RES" | jq -r .data.prompt_id)

# Vigila hasta el estado terminal y luego recopila las salidas
# Observa hasta el estado terminal y luego recopila las salidas
comfy --json jobs watch "$PROMPT_ID" | comfy download
```

Expand All @@ -157,38 +161,38 @@ comfy --json jobs watch "$PROMPT_ID" | comfy download
comfy run --workflow my_workflow.json --wait | comfy download
```

Sigue y administra las tareas:
Haz seguimiento y administra las tareas:

```bash
comfy jobs ls # envíos asíncronos locales + cola/historial del servidor
comfy jobs status <prompt_id> # una sola tarea
comfy jobs status <prompt_id> # una tarea
comfy jobs wait <id1> <id2> # bloquea hasta que TODAS lleguen a un estado terminal
comfy jobs cancel <prompt_id> # idempotente
```

<Tip>
Valida antes de enviar. Detecta nodos desconocidos, modelos faltantes y conexiones incorrectas antes de consumir cómputo en la nube:
Valida antes de enviar. Detecta nodos desconocidos, modelos faltantes y conexiones incorrectas antes de gastar cómputo en la nube:

```bash
comfy validate --workflow my_workflow.json
```
</Tip>

## Comenzar desde una plantilla
## Iniciar desde una plantilla

La galería curada `Comfy-Org/workflow_templates` es la forma más rápida de obtener un flujo de trabajo que ya funciona para una tarea determinada. No necesitas construirlo desde cero.
La galería seleccionada `Comfy-Org/workflow_templates` es la forma más rápida de obtener un flujo de trabajo confiable para una tarea determinada. No necesitas construirlo desde cero.

```bash
comfy templates ls --type image --tag "Text to Image" # explorar
comfy templates show <name> # metadatos completos
comfy templates fetch <name> --out my.json # obtén el JSON del flujo de trabajo
comfy templates fetch <name> --out my.json # obtener el JSON del flujo de trabajo
```

El JSON descargado está en formato del frontend. `comfy run --where cloud` lo convierte automáticamente a formato API al enviarlo.
El JSON descargado está en formato de frontend. `comfy run --where cloud` lo convierte automáticamente a formato API al enviarlo.

## Editar flujos de trabajo en su lugar

`comfy workflow` expone los slots editables por el agente en cualquier flujo de trabajo en formato frontend y te permite sobrescribirlos. Sin cirugía manual de JSON.
`comfy workflow` expone las ranuras que un agente puede modificar en cualquier flujo de trabajo en formato de frontend y te permite sobrescribirlas. Sin cirugía manual del JSON.

```bash
comfy workflow slots my.json # list addressable slots
Expand All @@ -207,16 +211,15 @@ comfy workflow save my.json --name "My Flow"
comfy workflow delete <id>
```

Para canalizaciones complejas de varios pasos, combina fragmentos pequeños y reutilizables en un solo gráfico:
Para pipelines complejos de varios pasos, compón fragmentos pequeños y reutilizables en un solo gráfico:

```bash
comfy workflow compose blueprints/my_pipeline.yaml -o workflows/my_pipeline.json
comfy workflow decompose my.json # inverse: project a workflow into a fragment
```

## Descubrir nodos y modelos

Inspecciona todo lo que esté disponible en el backend resuelto.
Inspecciona todo lo disponible en el backend resuelto.

**Nodos:**

Expand All @@ -234,22 +237,21 @@ comfy models list-folders # every model folder
comfy models search --text "wan2.2" --type lora
comfy models show wan2.2_vae.safetensors # full metadata
```

## Subir y descargar archivos

```bash
comfy upload photo.png video.mp4 # → directorio de entrada del servidor
comfy upload photo.png video.mp4 # → server input directory
comfy download <prompt_id> # → ./outputs/
```

<Tip>
**La tubería idiomática:**
**El pipe idiomático:**

```bash
comfy run --workflow flux.json --wait | comfy download
```

`comfy download` lee el prompt_id y las URLs de salida desde el stdin canalizado de forma automática. Sin extracción manual de claves, sin `jq`.
`comfy download` lee el prompt_id y las URLs de salida desde stdin canalizado automáticamente. Sin extracción manual de claves, sin `jq`.
</Tip>

## Administrar nodos personalizados
Expand All @@ -267,10 +269,9 @@ Descarga modelos fácilmente:
```bash
comfy model download --url <url> --relative-path models/checkpoints
```

## Salida JSON para scripts y agentes

Todos los comandos aceptan `--json` y emiten la misma estructura de envoltura, lo que hace que la CLI se pueda usar por completo en scripts y sea cómoda para los agentes:
Todos los comandos aceptan `--json` y emiten la misma forma de envoltura, lo que hace que la CLI sea totalmente compatible con scripts y fácil de usar para agentes:

```json
{
Expand All @@ -289,19 +290,18 @@ Cuando `error` está presente, lee el `hint` y actúa en consecuencia:
comfy --json run --workflow my.json | jq '.error.hint'
```

La superficie orientada a agentes se describe a sí misma por completo. Vuelca todo el árbol de comandos, los esquemas de salida y los códigos de error:
La superficie orientada a agentes es completamente autodescriptiva. Vuelca todo el árbol de comandos, los esquemas de salida y los códigos de error:

```bash
comfy --json discover
```

## Habilidades de agente
## Habilidades de agentes

<AgentSkills/>

## Contribuir

Las contribuciones son bienvenidas. Abre un problema o envía un pull request en el [repositorio de GitHub de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues). Consulta la [Guía para desarrolladores](https://github.com/Comfy-Org/comfy-cli/blob/main/CONTRIBUTING.md) para más detalles.
Las contribuciones son bienvenidas. Abre problemas o envía pull requests en el [repositorio de GitHub de comfy-cli](https://github.com/Comfy-Org/comfy-cli/issues). Consulta la [Guía para desarrolladores](https://github.com/Comfy-Org/comfy-cli/blob/main/CONTRIBUTING.md) para más detalles.

## Analítica

Expand All @@ -311,10 +311,10 @@ El seguimiento de uso ayuda a mejorar la CLI. Desactívalo con:
comfy tracking disable
```

Vuelve a activar el seguimiento:
Vuelve a activar el seguimiento con:

```bash
comfy tracking enable
```

También puedes optar por desactivarlo de forma definitiva mediante las variables de entorno `DO_NOT_TRACK` o `COMFY_NO_TELEMETRY`.
También puedes desactivarlo por completo mediante las variables de entorno `DO_NOT_TRACK` o `COMFY_NO_TELEMETRY`.
Loading
Loading