Kokon

La pantalla de configuración elige un ajuste preestablecido según tu VRAM. En un Mac, los ajustes se nombran por memoria unificada (Mac de 16–24 GB, Mac de 32–36 GB, Mac de 48 GB, Mac de 64 GB+), porque la parte gráfica puede usar solo alrededor de dos tercios de ella y el codificador de texto comparte la misma memoria. Puedes cambiar el ajuste más tarde desde Configuración → Modelos → Configurar modelos…

Cada ajuste preestablecido también incluye stable-diffusion.cpp (la compilación CUDA 12 en NVIDIA, la compilación Vulkan en AMD e Intel, la compilación Metal en un Mac), el VAE de Qwen-Image 2.1 y el proyector de visión Qwen3-VL y, en un PC, el mejorador de escala Superscale-SP (67 MB). El modelo de imagen es el Qwen-Image 2.1 Turbo oficial de 8 pasos de Qwen a través de DogukanUrker/Qwen-Image-2.1-Turbo-GGUF; las otras fuentes son Qwen/Qwen3-VL-8B-Instruct-GGUF y Comfy-Org/Qwen-Image-2.1.

Los archivos van a %LOCALAPPDATA%\KokonData\sdcpp (Mac: ~/Library/Application Support/KokonData/sdcpp) por defecto. Puedes apuntar la pantalla de configuración a una carpeta existente de stable-diffusion.cpp; los archivos que ya están allí se conservan. Otros pesos, como los ajustes finos, se pueden seleccionar en Configuración → Modelos.

.mcp.json con ámbito de proyecto, o cualquier host que acepte el formato estándar (en un Mac el comando es /Applications/Kokon.app/Contents/MacOS/kokon-mcp):

{
  "mcpServers": {
    "kokon": {
      "type": "stdio",
      "command": "C:\\Users\\<you>\\AppData\\Local\\Kokon\\kokon-mcp.exe",
      "args": []
    }
  }
}

Lo mismo desde la línea de comandos:

claude mcp add-json --scope user kokon '{"type":"stdio","command":"C:\\Users\\<you>\\AppData\\Local\\Kokon\\kokon-mcp.exe","args":[]}'

• Cada resultado devuelve la ruta absoluta del archivo guardado, su tamaño, semilla y metadatos de generación.
• Las rutas pueden ser absolutas o relativas al proyecto (CLAUDE_PROJECT_DIR). Las lecturas y escrituras están limitadas a la carpeta del proyecto, la carpeta de salida de Kokon y las carpetas listadas en QLS_MCP_ALLOWED_DIRS (separadas por punto y coma). Los archivos existentes nunca se sobrescriben.
• Las imágenes no se envían de vuelta al modelo por defecto; permanecen en el disco. Pasa include_preview: true para incluir una vista previa JPEG pequeña.
• upscale_image toma scale (por defecto 2) o width/height (hasta 8192 px).
• El progreso se informa mediante notificaciones de progreso de MCP. El tiempo de espera predeterminado de la herramienta de Claude Code es 30 minutos (MCP_TOOL_TIMEOUT).
• Sin la ventana de escritorio abierta, el modelo se descarga después de 15 minutos de inactividad (Configuración → General).

URL base http://127.0.0.1:39151/api/v1. Cada llamada excepto /ping necesita Authorization: Bearer <token>, con el token de %LOCALAPPDATA%\KokonData\service.json (Mac: ~/Library/Application Support/KokonData/service.json). Las solicitudes que llevan un encabezado Origin de navegador son rechazadas.

$i = Get-Content "$env:LOCALAPPDATA\KokonData\service.json" | ConvertFrom-Json
$h = @{ Authorization = "Bearer $($i.token)" }
Invoke-RestMethod -Method Post "http://127.0.0.1:$($i.port)/api/v1/generate" -Headers $h `
  -ContentType 'application/json' -Body '{"prompt":"a lighthouse at dusk, 16:9","quality":"fast"}'

Campos de operaciones simples: prompt, image / images[], mask, action (edit|remove|replace|add, inpainting), width, height, aspect_ratio, quality (fast|balanced|quality), seed, output_path, preserve_dimensions, private, left/right/top/bottom + units (pixels|percent) para outpainting, scale para upscaling. Las solicitudes completas (/jobs) también aceptan "mode": "upscale" con "upscale": {"scale" | "width"/"height"}.

SmartScreen muestra esto para aplicaciones nuevas que aún no tienen historial de descargas. Haz clic en Más información → Ejecutar de todos modos. Puedes verificar el instalador contra el hash SHA-256 listado en las notas de la versión, o compilarlo tú mismo.

Kokon no está notarizado por Apple (eso requiere una cuenta de desarrollador de Apple de pago), por lo que macOS lo bloquea la primera vez. Solo haces esto una vez; las actualizaciones dentro de la aplicación no lo activan de nuevo.

1. Abre Kokon. macOS dice “Kokon” no se abrió: haz clic en Listo (no Mover a la Papelera).

   

2. Abre Configuración del Sistema → Privacidad y Seguridad y desplázate hacia abajo hasta Seguridad. Junto a “Kokon” fue bloqueado para proteger tu Mac, haz clic en Abrir de todos modos, luego confirma con tu contraseña o Touch ID.

   

3. Abre Kokon nuevamente y haz clic en Abrir en el último aviso.

También puedes compilarlo tú mismo.

Solo para descargar los modelos. Después de eso, Kokon funciona completamente sin conexión. Si estás en línea, verifica una vez al día si hay una nueva versión, lo que puedes desactivar en la pantalla de bienvenida o en Configuración → General.

AMD e Intel: en beta. La pantalla de configuración instala la compilación Vulkan de stable-diffusion.cpp para ellos, que usa el controlador gráfico que ya tienes. Funciona en tarjetas NVIDIA, pero no se ha verificado en una tarjeta AMD o Intel real todavía; los gráficos integrados no son compatibles. Por favor, abre un problema con tu tarjeta y cómo fue.

Mac: sí, en beta, en Apple Silicon (M1 o más reciente) con macOS 26. Se ejecuta en un Mac de 16 GB en un modo más ligero, pero lentamente (aproximadamente 4 minutos por imagen de 1 megapíxel en un M2 Pro); se recomiendan 32 GB o más y un chip Pro, Max o Ultra. Consulta los requisitos y docs/platforms.md.

No con buenos resultados hoy. Qwen-Image 2.1 es un modelo grande, y 12 GB es el tamaño más pequeño para el que Kokon está diseñado. Las tarjetas más pequeñas pueden venir con modelos más ligeros en el futuro.

No con el modelo predeterminado. El código de Kokon es de código abierto (ver Licencia), pero el modelo de imagen tiene su propia licencia: Qwen-Image 2.1 y su modelo Turbo se publican bajo la Licencia de Investigación Qwen, que permite solo investigación y evaluación, sin uso comercial. Eso incluye vender o usar comercialmente las imágenes que creas con él. Para uso comercial, solicita una licencia al equipo de Qwen (model-business@notice.qwencloud.com).

El codificador de texto Qwen3-VL es Apache-2.0. El upscaler predeterminado, Superscale-SP de Nmkd, es WTFPL, y el MoSR experimental de Philip Hofmann es CC BY 4.0: ambos permiten uso comercial. El upscaler opcional UltraSharp es CC BY-NC-SA 4.0, solo no comercial.

Las fotos HEIC/HEIF se abren como cualquier otra imagen. En un Mac se decodifican por macOS mismo. En Windows, deben instalarse las Extensiones de imagen HEIF y las Extensiones de video HEVC de Microsoft.

Las fotos de iPhone con un mapa de ganancia HDR (iOS 18+) muestran un interruptor Mantener HDR en Avanzado, que está activado por defecto. Las ediciones de tales fotos se guardan como JPEG Ultra HDR: Chrome, Edge, Android y los sistemas Apple recientes las muestran en HDR, y cualquier otro visor muestra un JPEG normal. Esto necesita ffmpeg 7.1+ en PATH; sin él, el resultado se guarda en SDR y las notas del trabajo explican por qué.

Por defecto Superscale-SP de Nmkd (ESRGAN), descargado por la pantalla de configuración; en un Mac, Lanczos, porque los upscalers de IA tardan minutos allí (Superscale-SP: 5 min 45 s para ampliar una imagen de 1024×1024 a 2048×2048 en un M2 Pro, frente a aproximadamente un segundo). Elige otro en el menú Avanzado junto a la indicación, o en Configuración → Modelos; Comparar upscalers allí muestra cada uno en los mismos recortes (una cara, una foto JPEG, una calle nocturna, texto, un paisaje, un upscale 4×):

• Superscale-SP (predeterminado): nítido y natural en la mayoría de las imágenes; en fotos JPEG y áreas oscuras puede dibujar una cuadrícula tenue.
• MoSR (experimental, 17 MB, viene con la aplicación): el más rápido, bueno para upscales 4×, pero en imágenes limpias ampliadas menos de aproximadamente 3× dibuja una cuadrícula fina. Necesita la compilación de Kokon de stable-diffusion.cpp (solicitud de extracción al proyecto original).
• UltraSharp (descarga opcional): muy limpio, pero suaviza la piel en un aspecto artificial y puede inventar líneas. Licencia no comercial.
• Lanczos: un redimensionamiento simple, nunca inventa nada.

Fuerza del upscaler (0–100 %) mezcla el resultado del upscaler con un redimensionamiento simple, para atenuar la textura que inventa. Configuración → Modelos también tiene Reducir la imagen antes del upscaling, que le da al upscaler una imagen más pequeña, como las que se usaron para entrenarlo.

Windows: Configuración → Aplicaciones → Aplicaciones instaladas → Kokon → Desinstalar. El desinstalador pregunta si también deseas eliminar los modelos descargados y los datos de la aplicación (%LOCALAPPDATA%\KokonData).

Mac: arrastra Kokon desde Aplicaciones a la Papelera. Para liberar también el espacio de los modelos, elimina ~/Library/Application Support/KokonData.

Tus imágenes permanecen en tu carpeta de Imágenes.

Si una descarga falla, la pantalla de configuración muestra la página de descarga del archivo y la carpeta de destino para que puedas obtenerlo manualmente. Para cualquier otra cosa, por favor abre un problema con tu GPU (o modelo de Mac), controlador o versión de macOS y el registro de KokonData/logs (consulta la tabla anterior).

Windows: Rust (estable, MSVC), Node 22+, Visual Studio Build Tools y WebView2.

npm install
cargo test -p qls-core            # core unit tests
npx vitest run                    # UI logic tests
cd mcp; npx vitest run; cd ..     # MCP tests (includes a stdio protocol test)
npx tauri dev                     # run the desktop app in development
powershell -ExecutionPolicy Bypass -File scripts\build-release.ps1   # installer

Mac (Apple Silicon, macOS 26+): Xcode Command Line Tools, Rust y Node 22+.

bash scripts/dev/mac-dev.sh --check   # check the prerequisites
bash scripts/dev/mac-dev.sh           # build and run the app in development
bash scripts/build-release-mac.sh     # Kokon.app + .dmg in dist-release/

Publicar una versión (actualizaciones integradas firmadas para ambas plataformas) se describe en docs/releasing.md.

flowchart TB
    UI["<b>Kokon</b><br>Tauri 2 + React"]
    MCP["<b>kokon-mcp</b><br>MCP over stdio"]
    S["Scripts and other apps"]
    SVC["<b>kokon-service</b><br>planner · preprocessing · job queue · gallery<br><code>127.0.0.1:39151/api/v1</code>"]
    SD["<b>sd-server</b><br>stable-diffusion.cpp (CUDA · Vulkan · Metal)<br><code>127.0.0.1:39150</code>"]
    UI -- "HTTP + SSE, token" --> SVC
    MCP -- "HTTP, token" --> SVC
    S -- "HTTP, token" --> SVC
    SVC -- "native async API" --> SD

El núcleo en Rust (crates/qls-core) contiene toda la lógica: geometría, procesamiento de imágenes, planificación, el adaptador de inferencia, la cola de trabajos y la galería. El servicio, la aplicación de escritorio y el servidor MCP son capas delgadas encima. Consulta las notas de ingeniería para ver un mapa de módulos y los hechos del backend en los que se basa cada valor predeterminado.