Skip to content
Merged
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
97 changes: 71 additions & 26 deletions es/installation/desktop/usage/migrate.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,18 @@ title: "Migrar desde Legacy Desktop"
description: "Aprende a migrar tu instalación de Legacy Desktop a Comfy Desktop"
icon: "arrow-right"
sidebarTitle: "Migrar"
translationSourceHash: 5f3f3100
translationSourceHash: 61722fce
translationFrom: installation/desktop/usage/migrate.mdx
translationBlockHashes:
"_intro": 14240c76
"What Gets Migrated": 91f931e9
"What Changes After Migration": 1f09d2db
"What Gets Migrated": 765895d5
"What Migration Backs Up": ee11ab03
"What Happens While Migration Runs": 250e4c95
"What Changes After Migration": eae3f0a4
"Does My Old Link Still Work?": 528b3e43
"Step-by-Step Migration": d15dfd28
"Migrate from the Chooser": 9517089b
"Troubleshooting": a6cd9f9b
"Step-by-Step Migration": 0097aff9
"Migrate from the Chooser": 384ed466
"Troubleshooting": 787c900c
---

<Info>
Expand All @@ -32,25 +34,67 @@ Si ya tienes Legacy Desktop instalado, Comfy Desktop puede detectarlo y migrarlo
Legacy Desktop era una aplicación de instalación única. Comfy Desktop es un administrador de múltiples instalaciones. Cuando migras:

- **Flujos de trabajo y configuraciones**: se reutilizan en el mismo lugar, por lo que la nueva instancia conserva los mismos datos de usuario.
- **Nodos personalizados**: se escanean y se reinstalan en el nuevo entorno.
- **Modelos**: tu carpeta de modelos existente se agrega como un directorio compartido, por lo que los archivos permanecen donde están.
- **Nodos personalizados**: se quedan en tu carpeta `custom_nodes` existente. La instalación migrada usa tu carpeta de datos de Legacy Desktop como directorio base, así que carga los mismos nodos, y sus paquetes permanecen en el entorno de Python que se reutiliza.
- **Modelos**: tu carpeta de modelos existente se agrega a los directorios de modelos compartidos, para que todas las instalaciones puedan leer esos archivos donde ya están.
- **Archivos de entrada y salidas**: se reutilizan en el mismo lugar desde las carpetas existentes.
- **Entorno de Python**: tu entorno existente se valida y se reutiliza, con los paquetes que ComfyUI necesita instalados en él.
- **Entorno de Python**: tu entorno existente se valida y luego se reutiliza. Comfy Desktop comprueba que puede importar torch y después instala en él los requisitos propios de ComfyUI sin reemplazar tus paquetes de PyTorch.
- **Versión de ComfyUI**: la fuente de ComfyUI se prepara en un nuevo directorio administrado, de modo que Comfy Desktop administra las actualizaciones a partir de entonces.

La aplicación Legacy Desktop permanece instalada, y Comfy Desktop hace una copia de seguridad de tu estado de Legacy Desktop antes de iniciarse. La migración reutiliza esa configuración en el mismo lugar en vez de copiarla, por lo que la carpeta de datos compartida y el entorno de Python no son una copia intacta. Si necesitas una copia original sin modificar de tu configuración de Legacy Desktop, haz una copia de seguridad por tu cuenta antes de migrar.
La migración reutiliza tu carpeta de datos y tu entorno de Python de Legacy Desktop en el mismo lugar en vez de copiarlos, así que acabas con un único entorno en uso y no con una segunda copia. Si necesitas una copia original sin modificar de tu configuración de Legacy Desktop, haz una copia de seguridad por tu cuenta antes de migrar.

## Qué se incluye en la copia de seguridad

Antes de cambiar nada, Comfy Desktop copia los archivos de configuración de Legacy Desktop en una carpeta con fecha dentro de la carpeta de configuración de Legacy Desktop:

- macOS: `~/Library/Application Support/ComfyUI/legacy-backup/<timestamp>/`
- Windows: `%APPDATA%\ComfyUI\legacy-backup\<timestamp>\`

Solo se copian los archivos que existen:

- `config.json`: la configuración de la aplicación Legacy Desktop, incluida la carpeta de datos que usaba.
- `comfy.settings.json`: la configuración del frontend de ComfyUI guardada en tu carpeta de usuario de Legacy Desktop.
- `extra_models_config.yaml`: las rutas de modelos adicionales que configuraste en Legacy Desktop.
- `window.json`: el tamaño y la posición de la ventana guardados.

La copia contiene solo configuración. Los modelos, flujos de trabajo, nodos personalizados, archivos de entrada y salidas no se copian en ella, porque la instalación migrada sigue usándolos donde están. La migración también escribe una instantánea del entorno de Legacy Desktop, con sus nodos personalizados y paquetes instalados, en `.snapshots/` dentro de tu carpeta de datos de Legacy Desktop.

Si un archivo no se puede copiar, la migración lo anota en el registro y continúa, así que un fallo de la copia no detiene la migración.

## Qué ocurre durante la migración

La migración muestra su propia pantalla de progreso y avanza por estos pasos:

1. **Back up legacy state**
2. **Check folder access** (solo macOS)
3. **Validate Python environment**
4. **Capture snapshot**
5. **Allocate install folder**
6. **Stage ComfyUI source code**
7. **Install requirements**
8. **Carry over settings**
9. **Register installation**

Algunos pasos se detienen a esperar una respuesta:

- **Folder access needed** (macOS): macOS bloqueó el acceso a la carpeta de Legacy Desktop. Concede a Comfy Desktop el acceso a todo el disco en Ajustes del Sistema → Privacidad y seguridad y vuelve a iniciar la migración.
- **Python environment looks broken**: el entorno de Legacy Desktop no pudo importar torch. Selecciona **Adopt anyway** para seguir con ese entorno o **Cancel** para detenerte.
- **ComfyUI source code unavailable**: no se pudo obtener el código fuente de ComfyUI para la nueva instalación. Selecciona **Retry**, o **Cancel** y crea una instalación nueva desde el panel.

La pantalla guarda la salida de cada paso en un panel **View logs** que se abre solo cuando un paso falla. Copia el texto con el botón de copiar del panel, o lee la misma salida en el registro de la aplicación de Desktop. Un fallo al instalar los requisitos se registra como aviso y no detiene la migración.

## Qué cambia después de la migración

Una vez que se completa la migración, tu nueva instalación Standalone funciona como cualquier otra instalación de Comfy Desktop:

- **Inicio**: haz clic en el botón Reproducir de la tarjeta de la nueva instalación en la vista Selector para iniciar ComfyUI.
- **Puerto**: Legacy Desktop usaba el puerto `8000` de forma predeterminada. La nueva instalación conserva esta configuración de puerto (y cualquier otro argumento de inicio personalizado que tuvieras).
- **Puerto**: el puerto y cualquier otro argumento de inicio personalizado de tu configuración de Legacy Desktop se conservan.
- **Administrar**: usa el panel Administrar para actualizar, tomar instantáneas y configurar la instalación.
- **Actualizaciones**: las instalaciones Standalone se pueden actualizar de forma independiente a través del panel Administrar. A diferencia de Legacy Desktop, ya no necesitas descargar una nueva compilación para cada actualización.
- **Varias instancias**: puedes tener varias instalaciones Standalone en paralelo, cada una con su propia versión de ComfyUI y su propia configuración.
- **Almacenamiento compartido**: los modelos se comparten entre todas las instalaciones Standalone de forma predeterminada. Los directorios de entrada y salida están fijados al espacio de trabajo de Legacy Desktop adoptado, para que tus archivos existentes permanezcan donde están.

Una instancia migrada no actualiza ComfyUI por su cuenta. Usa la [pestaña Actualizar](/es/installation/desktop/usage/manage#pestaña-actualizar) del panel Administrar cuando quieras una versión de ComfyUI más reciente.

## ¿Mi enlace anterior sigue funcionando?

Legacy Desktop se ejecutaba en el puerto `8000` de forma predeterminada. La nueva instalación **conserva el puerto** de tu configuración de Legacy Desktop, así que `http://localhost:8000` debería seguir funcionando. Si tenías argumentos de CLI personalizados configurados (por ejemplo, `--port 8188`), esos también se conservan.
Expand All @@ -71,14 +115,11 @@ Cuando abras Comfy Desktop por primera vez, la configuración inicial detecta cu
</Step>

<Step title="Confirma la migración">
Selecciona **Continuar** y luego confirma **Migrar Legacy Desktop a Standalone** con **Iniciar migración**. Comfy Desktop hará lo siguiente:
Selecciona **Continuar** y luego confirma **Migrar a Standalone** con **Iniciar migración**. Comfy Desktop hará lo siguiente:

1. Analizar tu instalación existente (nodos personalizados, modelos, flujos de trabajo)
2. Reutilizar tu carpeta de datos y tu entorno de Python existentes en su lugar, y preparar el código fuente de ComfyUI en un nuevo directorio gestionado para que las actualizaciones funcionen con normalidad
3. Reutilizar tus flujos de trabajo, configuraciones y otros datos de usuario en su lugar
4. Reutilizar tus archivos de entrada y tus salidas en su lugar
5. Agregar tu carpeta de modelos como directorio compartido
6. Instalar los nodos personalizados en el nuevo entorno
1. Reutilizar tus flujos de trabajo, configuraciones, nodos personalizados, entradas y salidas en su lugar
2. Reutilizar tu entorno de Python y preparar el código fuente de ComfyUI en un nuevo directorio gestionado para que las actualizaciones funcionen con normalidad
3. Agregar tu carpeta de modelos como directorio compartido e instalar los requisitos de ComfyUI en el entorno reutilizado

Al finalizar, la nueva tarjeta de instalación Standalone aparece en la vista del selector.
</Step>
Expand Down Expand Up @@ -108,7 +149,7 @@ Si ya finalizaste la configuración inicial, o la instalación de Legacy Desktop

![Confirmación para migrar Legacy Desktop a Standalone con Start Migration](/images/desktop/usage/migrate_04_confirm.png)

Una instalación de Legacy Desktop se adopta en su ubicación actual, por lo que la instancia que aparece es tu configuración existente bajo la gestión de Comfy Desktop. En cambio, migrar una instalación registrada de Git o portable crea una nueva instancia Standalone y deja la instalación registrada en su lugar. En ambos casos, la aplicación no copia los archivos de modelo; los lee desde donde ya están.
Una instalación de Legacy Desktop se adopta en su ubicación actual, por lo que la instancia que aparece es tu configuración existente bajo la gestión de Comfy Desktop. En cambio, migrar una instalación registrada de Git o portable crea una nueva instancia Standalone y deja la instalación registrada en su lugar.

Una actualización pendiente tiene prioridad en esas tarjetas: muestran el distintivo de actualización en lugar de **Migrate**.

Expand All @@ -123,14 +164,18 @@ La fuente Legacy Desktop es solo para migración y no aparece en el selector de

### La migración falla

- **Revisa los registros** en la pestaña Terminal del panel Administrar para ver los detalles del error
- **Asegúrate de que tu instalación de Legacy Desktop esté intacta**: la migración lee desde tu instalación existente
- **Inténtalo de nuevo**: los problemas de red pueden resolverse en un segundo intento
- **Revisa el registro**: selecciona **View logs** en la pantalla de migración, o abre el registro de la aplicación de Desktop (`app.log`) en `~/Library/Logs/Comfy Desktop` (macOS) o `%APPDATA%\Comfy Desktop\logs` (Windows).
- **Comprueba que la instalación de Legacy Desktop está completa**: la migración lee modelos, flujos de trabajo y nodos personalizados de la carpeta existente, así que una carpeta movida o eliminada la detiene.
- **Inténtalo de nuevo**: un problema de red puede detener el paso de preparación del código fuente, y un segundo intento puede funcionar.

### La migración se detuvo antes de terminar

Si seleccionas **Cancel** en uno de los avisos, la ejecución se detiene, y lo mismo ocurre si un paso falla de forma clara. Un aviso de instalación de requisitos no la detiene. Una ejecución detenida no agrega una instancia al Selector, así que inicia la migración otra vez desde el distintivo **Migrate** de la tarjeta. Tu carpeta de Legacy Desktop no se elimina.

### Modelos faltantes después de la migración

Los modelos se agregan como una ruta de directorio compartida (no se copian). Si los modelos no aparecen:
Los modelos se agregan a los directorios de modelos compartidos, no se copian. Si los modelos no aparecen:

1. Abre el panel **Administrar** de la instalación migrada
2. Ve a la pestaña **Almacenamiento** y abre **Directorios de modelos**
3. Comprueba si tu carpeta de modelos antigua aparece en la lista. Si no es así, agrégala manualmente.
1. Abre [Desktop Settings → Storage](/es/installation/desktop/usage/settings#almacenamiento)
2. Comprueba que tu carpeta de modelos anterior y las rutas de modelos adicionales indicadas en el `extra_models_config.yaml` de Legacy Desktop están en los directorios compartidos. Si falta alguna, selecciona **+ Add Shared Directory** y elígela.
3. En el panel Administrar de la instancia migrada, abre la pestaña **Almacenamiento** y asegúrate de que **Include Shared Directories** está activado.
Loading
Loading