> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de instancias

> Crea, edita, renombra y elimina instancias de ComfyUI en Comfy Desktop

Comfy Desktop te permite administrar varias instancias de ComfyUI desde la vista Selector.

### Tipos de instancia

Comfy Desktop admite cuatro tipos de instancias. Cada tipo aparece en su tarjeta y en la barra de título; las instancias **Rastreadas** comparten el icono de **Independiente**.

| Tipo | Icono | Descripción |
| - | - | - |
| **Independiente** | 💻 | Una instancia de ComfyUI autocontenida creada por Comfy Desktop. Incluye Python integrado, actualizaciones automáticas y compatibilidad total con instantáneas. Es la opción predeterminada al hacer clic en **Nueva instancia**. |
| **Cloud** | ☁️ | Una instancia de Comfy Cloud. Requiere una cuenta de Comfy Cloud. Las instancias Cloud se ejecutan en los servidores de Comfy y se facturan por separado. |
| **Remota** | 🌐 | Se conecta a una instancia de ComfyUI que se ejecuta en otra máquina de tu red. Configura el host y el puerto remotos durante la configuración. |
| **Rastreada** | 💻 | Rastrea una instalación existente de ComfyUI (clon de Git o portable). Usa el mismo icono que **Independiente**. Tú administras las actualizaciones manualmente. Consulta [Rastrear una instalación existente](#seguimiento-de-una-instalación-existente). |

La siguiente imagen señala las acciones clave disponibles en cada tarjeta de instancia:

![Menú ⋮ de la tarjeta de instancia: Administrar, Duplicar instancia, Mostrar en Finder, Exportar instantánea, Restaurar instantánea, Desinstalar](https://mintcdn.com/dripart/PBKxxhs8nJtECa3d/images/desktop/interface/interface_instance_menu.png?fit=max\&auto=format\&n=PBKxxhs8nJtECa3d\&q=85\&s=0b9bb65143494b31d90c57470cb4b584)

1. **Nueva instancia**: Crea una instancia de ComfyUI desde cero. Consulta [Crear una nueva instancia](#crear-una-nueva-instancia). También puedes [crear una instancia a partir de un archivo de instantánea](https://docs.comfy.org/es/installation/desktop/usage/snapshots.md#crea-una-instancia-a-partir-de-un-archivo-de-instantánea).
2. **Menú ⋮**: Haz clic en el icono de tres puntos para abrir el menú de acciones de una instancia. Al hacer clic derecho en la tarjeta se abre el mismo menú.
3. **Administrar**: Abre el panel Administrar para configurar la instancia (ruta, argumentos de inicio, directorios de modelos, variables de entorno). Consulta la página [Administrar](https://docs.comfy.org/es/installation/desktop/usage/manage.md).
4. **Duplicar instancia**: Copia una instalación independiente, con su propio entorno de Python y nodos personalizados. Consulta [Duplicar una instancia](#duplicar-una-instancia).
5. **Mostrar en Finder**, **Mostrar en el Explorador** o **Mostrar en carpeta**: Abre la carpeta de instalación en tu administrador de archivos. El nombre depende de tu sistema operativo.
6. **Exportar instantánea**: Exporta la instantánea más reciente de la instancia a un archivo que puedas compartir. Consulta [Compartir una instantánea](https://docs.comfy.org/es/installation/desktop/usage/snapshots.md#compartir-una-instantánea).
7. **Restaurar instantánea**: Revierte la instancia a una instantánea anterior. Consulta la página [Instantáneas](https://docs.comfy.org/es/installation/desktop/usage/snapshots.md).
8. **Desinstalar**: Elimina de forma permanente la instancia y todos sus archivos del disco. Consulta [Desinstalar una instancia](#desinstalar-una-instancia).

El menú también enumera acciones que solo aparecen en ciertos estados: **Detener** mientras la instancia se está ejecutando, **Actualizar** cuando hay una nueva versión de ComfyUI disponible, **Migrar a Independiente** para una instalación que puedas migrar, y **Crear compilación** para una instancia local que puedas publicar en un espacio de trabajo. **Olvidar** no forma parte de este menú; se encuentra en el panel Administrar, consulta [Desinstalar una instancia](#desinstalar-una-instancia).

## Crear una nueva instancia

Haz clic en la tarjeta **+** (arriba a la izquierda) en la vista Selector para agregar una nueva instancia de ComfyUI.

**1. Crear una nueva instancia**

**Windows**

![El asistente Crear una nueva instancia en Windows, señalando el nombre (1), el modo de compilación (2), el canal de lanzamiento (3), el hardware (4) y la ubicación de instalación (5)](https://mintcdn.com/dripart/cAVuyhdaebQHS2CS/images/desktop/usage/new_install_01_settings_windows.png?fit=max\&auto=format\&n=cAVuyhdaebQHS2CS\&q=85\&s=f293743f357c88ea7639667b957053de)

**macOS**

![El asistente Crear una nueva instancia en macOS, señalando el nombre (1), el método de instalación (2), el canal de lanzamiento (3), el hardware (4) y la ubicación de instalación (5)](https://mintcdn.com/dripart/PBKxxhs8nJtECa3d/images/desktop/usage/new_install_01_settings_mac.png?fit=max\&auto=format\&n=PBKxxhs8nJtECa3d\&q=85\&s=3574ee56cd34b97aadfeb9a84df1aaf8)

**Linux**

![Asistente Crear una nueva instancia en Linux: nombre, Public Builds, lanzamiento, hardware (AMD/NVIDIA/Intel Arc) y ubicación de instalación con espacio libre](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/new_install_01_settings_linux.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=03b4201e96f77d5ecac7d8920268992e)

1. **Nombre**: el nombre de tu instancia. El valor predeterminado es "ComfyUI".
2. **Public Builds**: la opción recomendada. Una instalación estándar de ComfyUI creada para el hardware detectado. Selecciona **Managed Builds** para instalar un Build desde uno de tus espacios de trabajo (consulta [Espacios de trabajo y ComfyUI Builds](https://docs.comfy.org/es/installation/desktop/usage/workspaces-and-builds.md#instalar-un-build)), o **Conexión Remota** para conectarte a una instancia de ComfyUI que se ejecuta en otra máquina.
3. **Lanzamiento**: el canal de lanzamiento que se va a instalar. **Estable (RECOMENDADO)** viene preseleccionado.
4. **Hardware**: Comfy Desktop detecta tu GPU y preselecciona la compilación correspondiente (NVIDIA, AMD, Intel Arc (XPU) o CPU). Cada opción muestra la versión de ComfyUI, la versión de Python y el tamaño de la descarga.
5. **Ubicación de Instalación**: dónde se instala ComfyUI. En Windows, se recomienda encarecidamente usar un **SSD** y evitar la raíz de la unidad C:. El campo muestra el espacio libre en la unidad y una estimación del tamaño de la instalación cuando Comfy Desktop la conoce.

Si el espacio libre parece bajo, el asistente muestra el diálogo **Low Disk Space**. Elige **Continue Anyway**, o cancela y selecciona otra ruta.

![Diálogo Low Disk Space que muestra el espacio libre frente al tamaño de instalación requerido, con Cancel y Continue Anyway](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/low_disk_space_dialog.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=7306da9f6d98179436d54fa23581eb62)

**2. Instalando**

![Progreso de la instalación: Descargando ComfyUI con porcentaje, rendimiento y pasos restantes](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/new_install_02_installing.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=56f28d2fc1eb721c2ef27d4229816095)

Comfy Desktop se encargará del resto: descargar Python, configurar el entorno e instalar ComfyUI. La pantalla de progreso muestra el paso actual.

**3. Elegir una plantilla**

![Paso Elegir un flujo de trabajo inicial con pestañas Vídeo/Imágenes/3D/Audio antes de que finalice la instalación](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/new_install_03_interface_template.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=c02ae0bffd0167cecf0fea20418cba79)

Una vez completada la instalación, Comfy Desktop abre la biblioteca de plantillas donde puedes elegir una plantilla de flujo de trabajo para empezar.

Las plantillas que descargan modelos necesitan suficiente espacio libre para esos archivos. Si la unidad no puede contener los modelos de una plantilla, el asistente bloquea esa opción. Elige una plantilla más ligera o libera espacio. En discos muy pequeños, el paso de plantillas puede omitirse por completo.

## Seguimiento de una Instalación Existente

Si ya tienes una instalación de ComfyUI (configurada manualmente desde el repositorio de Git o descargada como versión portable), puedes agregarla a Comfy Desktop sin crear una nueva.

Abre el menú ☰ en la barra de título y selecciona **Add Existing Instance**.

![El menú ☰ abierto en el Panel, con Add Existing Instance marcado (2)](https://mintcdn.com/dripart/PBKxxhs8nJtECa3d/images/desktop/usage/track_instance_01.png?fit=max\&auto=format\&n=PBKxxhs8nJtECa3d\&q=85\&s=843fefad1f2629325238092d45240b4e)

1. El botón de menú **☰** en la esquina superior izquierda de la barra de título.
2. **Add Existing Instance**: Abre el diálogo que rastrea una instalación existente de ComfyUI.

### Detectar tu Instalación

En el diálogo, haz clic en **Browse…** y selecciona la carpeta de instalación. Comfy Desktop sondea la carpeta y completa el resto del diálogo. El menú desplegable **Detected type** muestra lo que encontró:

* **Standalone**: Una instalación de Comfy Desktop. El sondeo busca un directorio `standalone-env` y `ComfyUI/main.py`.
* **Portable**: Una compilación portable de Windows. El sondeo busca `python_embeded`, ya sea en la carpeta que seleccionaste o en una carpeta directamente dentro de ella.
* **Git Clone**: Un clon del repositorio de ComfyUI. El sondeo busca un directorio `.git`.
* **Legacy Desktop**: Una instalación de la aplicación ComfyUI Desktop anterior, reconocida por sus directorios `models/`, `user/` y `.venv`. Consulta [Migrar desde Legacy Desktop](https://docs.comfy.org/es/installation/desktop/usage/migrate.md).

Si el sondeo no encuentra nada, el menú desplegable muestra **No known install detected**. Selecciona la carpeta que contiene la instalación en sí, no una carpeta principal ni una carpeta no relacionada.

### Confirmar la Instalación Detectada

Cuando el sondeo termina, el diálogo muestra lo que encontró. Revisa las rutas antes de rastrear la instalación.

![El diálogo Add Existing Instance con un clon de Git detectado: ubicación de instalación, versión, repositorio, rama y entorno virtual](https://mintcdn.com/dripart/PBKxxhs8nJtECa3d/images/desktop/usage/track_instance_02.png?fit=max\&auto=format\&n=PBKxxhs8nJtECa3d\&q=85\&s=49d1202e57fd41b6f4ca412b990c77cf)

* **Install location**: La carpeta que seleccionaste. Haz clic en la ruta para abrirla, o en **Browse…** para elegir otra. Para una compilación portable, apunta a la carpeta que contiene `python_embeded`.
* **Name**: Cómo se lista la instancia en el Chooser. El diálogo sugiere un nombre.
* **Detected type**: Qué tipo de instalación contiene la carpeta.
* **Version**, **Repository** y **Branch**: Se muestran para un clon de Git.
* **Virtual Environment**: Se muestra para un clon de Git cuando Comfy Desktop encuentra uno, en `.venv`, `venv`, `.env` o `env` con un archivo `pyvenv.cfg` dentro. **Browse…** apunta la instancia a un entorno diferente.

Haz clic en **Track Install** para agregar la instancia. No se mueve ni se copia ningún archivo.

### Rastreada vs Standalone

La diferencia clave entre una instalación **Rastreada** (Add Existing Instance) y una instalación **Standalone** es cómo se administran las actualizaciones:

| Aspecto | Rastreada (Existente) | Standalone |
| - | - | - |
| **Actualizaciones** | Sin actualizaciones automáticas: en un clon de Git haces el pull y reinstalas tú mismo, y una compilación portable se reemplaza por una más nueva | Actualizaciones automáticas integradas |
| **Python** | Usa un entorno de Python existente (`.venv`, `python_embeded`, etc.) | Python incluido, gestión automática de dependencias |
| **Aislamiento** | Comparte la ruta y el entorno existentes | Instalación completamente autocontenida y aislada |
| **Instantáneas** | No es compatible | Soporte de instantáneas disponible |
| **Caso de uso** | Ya tienes ComfyUI configurado y personalizado | Instalación nueva desde cero |

> **Nota:** Comfy Desktop ejecuta una instalación rastreada con su entorno de Python existente y no reinstala ComfyUI ni administra sus paquetes. La captura de instantáneas solo se ejecuta para instancias Standalone.

## Iniciar, detener y reiniciar una instancia

[↩ Volver a la descripción general](#overview)

### Iniciar una instancia

Haz clic en la tarjeta de una instancia en el Selector para iniciarla. Mientras ComfyUI arranca, la ventana muestra el progreso de inicio y, cuando el servidor está listo, la interfaz de ComfyUI.

### Iniciar mientras otra instancia está en ejecución

Cuando inicias una instancia local mientras otra instancia local está en ejecución o iniciándose, Comfy Desktop muestra un diálogo **Ya hay una instancia en ejecución** que enumera las instancias que detendría:

* **Cerrar e iniciar**: detiene las instancias enumeradas y luego inicia la que elegiste.
* **Ejecutar todas**: inicia la nueva instancia junto a las que ya están en ejecución.

Descarta el diálogo para cancelar el inicio. Reiniciar una instancia nunca muestra este diálogo. Para dejar de verlo, desactiva **Advertir antes de ejecutar varias instancias** en [Configuraciones de Escritorio → Preferencias](https://docs.comfy.org/es/installation/desktop/usage/settings.md#preferencias).

### Detener una instancia

Selecciona **Detener** en el menú ⋮ de la tarjeta de la instancia. El servidor de ComfyUI se detiene y la ventana permanece abierta con una tarjeta **ComfyUI está detenido**. Selecciona **Volver a iniciar ComfyUI** para arrancar el servidor de nuevo, o **Volver al Panel** para regresar al Selector.

### Reiniciar después de un fallo

Si ComfyUI no logra iniciarse o se cierra inesperadamente, la ventana permanece abierta con una tarjeta que describe lo que ocurrió:

* **ComfyUI no pudo iniciarse**: la instancia no arrancó.
* **ComfyUI se cerró inesperadamente**: el proceso se detuvo. Cuando Comfy Desktop puede leerlo, la tarjeta también muestra el código de salida, o la señal que terminó el proceso.

En Windows, un fallo puede reportar una violación de acceso a la memoria y señalar que algunos archivos de Microsoft Visual C++ Redistributable parecen faltar. Expande los registros de la tarjeta para ver los detalles y luego selecciona **Reiniciar ComfyUI** para iniciar de nuevo, o **Volver** para regresar al panel.

Si ComfyUI se detiene porque no puede abrir la base de datos de recursos que guarda dentro de la instalación, el error con el que se detiene explica el motivo en lugar de reportar solo un código de salida:

* **Otro ComfyUI está usando la base de datos de esta instalación**: cierra ese ComfyUI (o la aplicación que lo inició), o dale a uno de ellos su propia ubicación de base de datos con el argumento de inicio `--database-url`.
* **Cualquier otro fallo de la base de datos**, desde una bloqueada por otro programa hasta una escrita por una versión más reciente de ComfyUI o imposible de crear en esa carpeta: el mensaje indica el archivo y la solución, y termina con la opción de iniciar la instancia sin el sistema de recursos, agregando `--disable-assets` a sus argumentos de inicio.

## Desinstalar una instancia

[↩ Volver a la descripción general](#overview)

Cuando quieres eliminar una instancia, dos acciones determinan si sus archivos permanecen en el disco.

![Olvidar y Desinstalar en el menú Más del panel Administrar](https://mintcdn.com/dripart/PBKxxhs8nJtECa3d/images/desktop/usage/instance_uninstall.png?fit=max\&auto=format\&n=PBKxxhs8nJtECa3d\&q=85\&s=620dca5ad4180a25c2deb1d8165ff3fb)

1. **Olvidar**: Elimina la instancia de la aplicación sin borrar nada. La carpeta de instalación y todos sus datos permanecen en el disco. Úsalo cuando solo quieras limpiar la lista pero podrías necesitar la instancia más tarde.
2. **Desinstalar**: Elimina permanentemente la instalación y todos sus archivos del disco. Los archivos de modelo en directorios compartidos no se ven afectados.

**Desinstalar** también está en el menú ⋮ de la tarjeta de la instancia. **Olvidar** no forma parte de ese menú; lo encuentras en el panel Administrar, en el menú **Más** en la parte inferior del panel. Una instalación que Comfy Desktop adoptó, como una migrada desde Legacy Desktop, no tiene la acción **Olvidar**.

## Duplicar una instancia

[↩ Volver a la descripción general](#overview)

Puedes duplicar una instalación independiente existente. Abre el menú ⋮ de la tarjeta y selecciona **Duplicar instancia**, o usa **Duplicar instancia** en el menú **Más** del panel Administrar. La copia obtiene:

* Un nuevo entorno de Python
* La misma versión de ComfyUI
* Su propia configuración de nodos personalizados

Escribe un nombre para la copia duplicada cuando se te solicite. La copia se crea junto a la original. Las instalaciones en la nube, remotas y rastreadas no se pueden duplicar.

## Editar una instancia

[↩ Volver a la descripción general](#overview)

En el panel **Administrar** de una instancia, puedes:

* Cambiar la ruta de instalación
* Ajustar los argumentos de inicio
* Modificar los directorios de modelos
* Actualizar las variables de entorno
* Renombrar la instancia, desde el nombre en la parte superior de la pestaña **Acerca de** o desde **Renombrar** en el menú **Más**
* Cambiar la dirección de conexión de una conexión remota, en la pestaña **Acerca de**

Abre el panel **Administrar** haciendo clic derecho en la tarjeta de la instancia (o seleccionando **Administrar** en su menú ⋮).

## Estado de error

Si una instalación encuentra un problema, aparece una insignia **Error** en su tarjeta. Selecciona la insignia para leer los detalles: el mensaje, el código de salida o la señal cuando Comfy Desktop tenga uno, y las últimas líneas de la salida de error. Iniciar o reiniciar la instancia borra la insignia. Si el problema vuelve, revisa los registros en [Ubicaciones de datos](https://docs.comfy.org/es/installation/desktop/usage/settings.md#ubicaciones-de-datos).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.