Kiln
Control de agentes de IA sobre impresoras 3D reales: diseño, corte, impresión, monitoreo y recuperación en Bambu Lab, Creality, Prusa, Elegoo y más.
Documentación
El servidor MCP de código abierto para impresión 3D.
Kiln permite que los agentes de IA (Claude Desktop, Claude Code, Codex, o cualquier cliente MCP personalizado) controlen impresoras 3D reales de principio a fin: Bambu Lab, Creality, Prusa, Elegoo, Voron, Sovol, AnkerMake, Artillery, FlashForge, QIDI, RatRig y SparkX, a través de OctoPrint, Moonraker/Klipper, PrusaLink y USB directo.
En una sola conversación, un agente puede diseñar una pieza, cortarla en rebanadas, ponerla en cola en la impresora correcta, monitorear la cámara, recuperarse de fallos y enviar el resultado. Sin un humano en el medio.
¿Leyendo esto como agente de IA? kiln3d.com/agents está escrito para ti, no para la persona que te ejecuta: instalación, configuración de MCP, el ciclo de diseño a impresión, y exactamente qué Kiln se negará a hacer y por qué.
pip install kiln3d
"un posavasos con una foto de mi perro Ash" — de principio a fin, desde una sola frase.
Ver la demo →
Kiln está construido en abierto. Si hizo tu impresión más divertida, o solo te ahorró un dolor de cabeza, una ⭐ en el repositorio ayuda al próximo maker a encontrarlo.
Inicio rápido
¿Usas Claude Desktop? Instala Kiln con un clic. Descargar kiln.mcpb y haz doble clic — Claude Desktop instala Kiln y lo conecta (solo Claude Desktop: los pasos 1 y 2 a continuación son cómo se conectan Codex y cualquier otra aplicación de IA), así que esos pasos no son tuyos. Dos cosas siguen siendo tuyas: OpenSCAD y los términos de Kiln — el comando los muestra y te pide que escribas tu aceptación, por eso es tuyo y no de tu IA: uvx --from kiln3d kiln accept-terms. El paquete y ese comando se ejecutan en uv — gratis, con una instalación de una línea para cada plataforma en ese enlace. Si Claude Desktop dice que el servidor no pudo iniciarse, falta uv: instálalo y reinicia. Las actualizaciones llegan con la extensión, no vía kiln self-update.
Todos los demás — tres pasos. Luego pide a tu IA que haga algo.
1. Instalar
pip install kiln3d
2. Conecta tu IA — Kiln se configura solo dentro de Claude Desktop, Claude Code y Codex:
kiln signin # create your free account
kiln install-mcp # connects Kiln to your AI apps
Reinicia tu aplicación de IA y podrá ejecutar tu impresora. (Claude Code y Codex incluso pueden ejecutar toda esta configuración por ti — la versión de un solo prompt está en kiln3d.com/install). ¿Usas un cliente MCP diferente? kiln install-mcp --print imprime la configuración — o pégala tú mismo:
Configuración manual de MCP (cualquier cliente, sin necesidad de iniciar sesión)
{
"mcpServers": {
"kiln": {
"command": "python3",
"args": ["-m", "kiln", "serve"]
}
}
}
¿No necesitas instalar? Cambia el comando por un ejecutor sin instalación — "command": "uvx", "args": ["kiln3d", "serve"] (Python), o "command": "npx", "args": ["kiln3d"] (Node). Mismo servidor, nada que pip install.
Pégalo en Claude Desktop, Claude Code, Codex, Cursor, o cualquier agente compatible con MCP. Funciona en el nivel gratuito hasta que inicies sesión.
3. Pide — pega una frase como esta en tu agente. Kiln hace el resto:
Hazme un posavasos con la foto de mi perro
Ese es todo el camino feliz. Tu IA hace el diseño, el corte y la impresión — nunca tocas una CLI. Guía específica por sistema operativo (Windows, WSL 2, Linux) en kiln3d.com/install.
[!TIP]
kiln doctorverifica toda tu configuración y te dice exactamente qué arreglar.kiln self-updateactualiza en el lugar cuando llega una nueva versión.
¿Prefieres manejarlo tú mismo? (Recorrido por la CLI)
# Discover printers on your network (mDNS + HTTP probe)
kiln discover
# Add your printer (see the printer table under "Supported Printers")
kiln auth --name my-printer --host http://octopi.local --type octoprint --api-key YOUR_KEY
# Other types:
# kiln auth --name prusa --host http://192.168.1.100 --type prusalink --api-key YOUR_KEY
# kiln auth --name klipper --host http://192.168.1.100:7125 --type moonraker
# kiln auth --name bambu --host 192.168.1.100 --type bambu --access-code LAN_CODE --serial SERIAL
kiln status # Printer state + job progress
kiln upload model.gcode # Upload a file
kiln print model.gcode # Start printing
kiln slice model.stl --print-after # Slice an STL and print in one step
kiln print *.gcode --queue # Batch print
kiln wait # Monitor a running print
kiln snapshot --save photo.jpg # Webcam snapshot
kiln history --status completed # Print history
# Every command supports --json for agent consumption
kiln status --json
Opción global: --printer <name> apunta a una impresora específica por comando. La referencia completa de comandos está en Documentación del proyecto.
Conecta un agente específico (Claude Code, Claude Desktop, variables de entorno)
Claude Code — instala el plugin (una vez: instala uv primero si no lo tienes — es gratis y toma una línea):
claude plugin marketplace add codeofaxel/Kiln
claude plugin install kiln@kiln
O conéctalo a mano — añade a .claude/settings.json (proyecto) o ~/.claude/settings.json (global):
{
"mcpServers": {
"kiln": { "command": "kiln", "args": ["serve"] }
}
}
Claude Code usa tu ~/.kiln/config.yaml para las credenciales de la impresora (configuradas vía kiln setup o kiln auth). No se necesitan variables de entorno si ya hay una impresora configurada.
Claude Desktop — añade a ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"kiln": {
"command": "python3",
"args": ["-m", "kiln", "serve"],
"env": {
"KILN_PRINTER_HOST": "http://192.168.1.100",
"KILN_PRINTER_API_KEY": "your_key",
"KILN_PRINTER_TYPE": "prusalink"
}
}
}
}
Configura KILN_PRINTER_TYPE a tu backend: octoprint, moonraker, bambu, prusalink, elegoo, duet, o usb — u omite las variables de entorno por completo si ya ejecutaste kiln setup.
Cualquier otro LLM (OpenRouter) — Kiln funciona con cualquier modelo que soporte llamadas de función compatibles con OpenAI, no solo Claude:
export KILN_OPENROUTER_KEY=sk-or-...
kiln agent --model openai/gpt-4o
kiln agent --model meta-llama/llama-3.1-70b-instruct --tier essential
Los niveles de herramientas se ajustan automáticamente a la capacidad del modelo: esencial (15 herramientas) para modelos pequeños, estándar (60 herramientas) para gama media, completo (135 herramientas) para modelos más potentes. Todas las 908 herramientas están disponibles vía MCP a través de kiln serve.
Notas de configuración de plataforma e impresora (Linux/WSL 2, solo Ethernet, Bambu)
Requisitos previos por tipo de impresora
| Impresora | --type | Lo que necesitas |
|---|---|---|
| Prusa MK4/XL/Mini+ | prusalink | IP + clave API (Configuración › Red › PrusaLink en la pantalla LCD) |
| OctoPrint (cualquier impresora) | octoprint | URL de OctoPrint + clave API (Configuración › API) |
| Klipper/Moonraker | moonraker | URL de Moonraker (generalmente http://<ip>:7125) |
| Creality K1/K2/Hi/Ender V4/V3 KE | creality | IP + printer_model (p. ej. creality_k1_max); sondea puertos locales de Moonraker |
| Bambu Lab | bambu | IP + código de acceso LAN + número de serie (todo en la pantalla LCD) |
| Elegoo (SDCP) | elegoo | Solo IP — sin autenticación. Neptune 4 / OrangeStorm Giga usan moonraker. |
| Duet / RepRapFirmware | duet | Solo IP, más la contraseña de la máquina si está configurada (M551 en config.g). |
| USB directo (Marlin) | serial | Solo cable USB — sin red. Ender 3, Prusa MK3, CR-10, cualquier impresora Marlin/RepRap. |
Kiln solo necesita alcance por IP en tu LAN. Las impresoras solo Ethernet son totalmente compatibles.
Herramientas opcionales: PrusaSlicer, OrcaSlicer o BambuStudio para cortar STL → G-code (brew install --cask prusaslicer); OpenSCAD para generación local de texto a 3D — instala la versión actual (brew install --cask openscad@snapshot); configura KILN_GEMINI_API_KEY para habilitar geometría generada por Gemini.
Linux / WSL 2
pipx instala Kiln en su propio entorno aislado y coloca kiln en tu PATH. (El paquete pip es kiln3d; el comando CLI es kiln.)
sudo apt install pipx && pipx ensurepath
git clone https://github.com/codeofaxel/Kiln.git && cd Kiln
pipx install ./kiln
sudo apt install prusa-slicer # optional: slicing for printing
sudo snap install openscad --edge # optional: the design engine (current build)
kiln verify
# Update / uninstall
git pull && pipx install --force ./kiln
pipx uninstall kiln3d
Red de WSL 2: WSL 2 usa NAT, por lo que el descubrimiento mDNS (kiln discover) no verá impresoras en tu red doméstica. Conéctate directamente por IP en su lugar (igual que las configuraciones solo Ethernet).
Impresoras solo Ethernet (sin Wi-Fi)
Kiln funciona igual sobre Ethernet y Wi-Fi — habla con las APIs de la impresora a través de IP LAN. Verifica que el endpoint de la impresora responda, luego regístrala por IP:
curl http://<ip>/api/version # OctoPrint
curl http://<ip>:7125/server/info # Moonraker / Creality (local Moonraker)
curl -H "X-Api-Key: YOUR_KEY" http://<ip>/api/v1/status # Prusa Link
# Bambu uses MQTT — ensure port 8883 is reachable: nc -zv <ip> 8883
kiln auth --name my-printer --host http://<ip> --type prusalink --api-key YOUR_KEY
Si PrusaSlicer no está en tu PATH: export KILN_SLICER_PATH=/path/to/prusa-slicer.
TLS y cámara web de Bambu
Kiln fija el certificado de la impresora (TOFU) en la primera conexión en ~/.kiln/bambu_tls_pins.json. Anulaciones:
export KILN_BAMBU_TLS_MODE=ca # strict CA/hostname (usually fails on stock self-signed printers)
export KILN_BAMBU_TLS_MODE=insecure # legacy, no validation — trusted LANs only
export KILN_BAMBU_TLS_FINGERPRINT=0123abcd... # explicit SHA-256 pin
La captura de cámara web depende del modelo: A1, A1 Mini, P1P, P1S sirven fotogramas vía TLS+JPEG (sin software adicional). La serie X1 (X1C, X1E) sirve RTSPS, que Kiln retransmite vía ffmpeg — así que en una X1, tanto las instantáneas como la transmisión en vivo necesitan ffmpeg (brew install ffmpeg / sudo apt install ffmpeg). can_snapshot se reporta True para cada modelo Bambu; en una X1 sin ffmpeg, el intento muestra un error claro específico del modelo en lugar de fallar silenciosamente.
Los niveles de pago (kiln3d.com/pricing) añaden versionado Git-para-3D, plantillas de producto, manuales de ensamblaje, flujos de trabajo de flota, SSO + SCIM, webhooks de ERP y registros de auditoría a largo plazo.
¿Por qué Kiln?
- Un plano de control, cualquier impresora — OctoPrint, Moonraker, Creality, Bambu Lab, Prusa Link, Elegoo, Serial. Gestiona una flota mixta desde un solo lugar.
- ¿Sin impresora? Sin problema — Subcontrata trabajos a los más de 150 servicios de fabricación de Craftcloud a través del proxy alojado, o usa el modo directo con tus propias credenciales de proveedor.
- Nativo de IA — 915 capacidades MCP y 242 comandos CLI construidos para agentes de IA. No es una interfaz web con una API añadida.
- Descríbelo, imprímelo — Pipeline de lenguaje natural a objeto físico: texto o boceto → generación por IA → validación → corte → impresión.
- Decora cualquier cosa — Códigos QR, fotos, logotipos, texto, SVG y texturas procedurales (rayas de tigre, mármol, camuflaje, veta de madera, panal) en relieve o en bajorrelieve sobre cualquier modelo con un solo comando.
- Manuales incluidos — Las impresiones de múltiples partes pueden generar manuales de ensamblaje PDF imprimibles con lista de materiales, renders de pasos isométricos, flechas de acoplamiento y compuertas de verificación con pausa. (Business)
- Reanuda, no reinicies — ¿Impresión cancelada o fallida? Reanuda desde la capa exacta donde se detuvo en cualquier impresora FDM compatible. Sin desperdicio de filamento. (Pro)
- Modifica durante la impresión — Añade decoraciones, agrega características o cambia materiales en una impresión en vivo con reversión atómica si algo sale mal. (Pro)
- Enrutamiento inteligente de materiales — 25 materiales, 45 perfiles de filamento específicos por marca (Bambu, Prusament, Polymaker y más) en 11 familias de materiales. Recomendaciones basadas en intención con conciencia de capacidades de la impresora.
- Las impresiones no fallan en silencio — Aprendizaje entre impresoras, recuperación automática de fallos, retroalimentación de generación de IA en bucle cerrado (las impresiones fallidas mejoran automáticamente las generaciones futuras), verificaciones de seguridad previas al vuelo en cada trabajo.
- Impresiones condenadas detenidas temprano — ¿Demasiado grande para la placa de construcción, o un material que tu hotend no puede fundir? Detectado antes de que se desperdicie filamento, rotado para caber cuando sea posible, anulación con un comando. Pro muestra la solución: área útil real, el corte más limpio o el material al que cambiar.
- Buscar → Cortar → Imprimir — Busca y descarga modelos 3D de MyMiniFactory y Cults3D (solo búsqueda), corta automáticamente con PrusaSlicer, OrcaSlicer o BambuStudio, imprime — todo desde una conversación de agente.
- Seguridad a escala — 51 perfiles de seguridad nombrados por impresora, validación de G-code, vigilancia del calentador, registros de auditoría a prueba de manipulaciones. Enterprise añade G-code cifrado en reposo con rotación de claves, perfiles bloqueables, RBAC, SSO, agrupación de sitios de flota, seguimiento de costos por proyecto y PostgreSQL HA.
Impresoras Compatibles
| Backend | Estado | Impresoras |
|---|---|---|
| OctoPrint | Estable | Cualquier impresora conectada a OctoPrint (Prusa, Ender, personalizada) |
| Moonraker | Estable | Impresoras basadas en Klipper (Voron, Ratrig, etc.) |
| Creality | Estable cuando Moonraker es accesible | SPARKX i7, K1/K1 Max/K1C/K1 SE, K2/K2 Pro/K2 Plus/K2 SE, Creality Hi, Ender-3 V4/V3 KE, Ender-5 Max, CR-10 SE vía Moonraker local. Las impresoras Creality Marlin más antiguas usan serial o octoprint. |
| Bambu | Estable | Bambu Lab X1C, X1E, P1S, P1P, P2S, A1, A1 Mini, A2L, H2S, H2D, H2D Pro, H2C, X2D (vía LAN MQTT) |
| Prusa Link | Estable | Prusa MK4, XL, Mini+ (API REST local — tipo: prusalink) |
| Elegoo | Estable | Centauri Carbon, Saturn, serie Mars (vía LAN WebSocket/SDCP). Neptune 4 / OrangeStorm Giga usan Moonraker. |
| Duet / RepRapFirmware | Beta — aún no verificado contra hardware físico | Placas controladoras Duet 2 y Duet 3, a través de la misma interfaz HTTP que usa Duet Web Control. Se admiten RepRapFirmware 2 y 3. Vision Miner 22 IDEX v4 es la primera máquina catalogada. Tipo: duet. |
| USB directo | Estable | Cualquier impresora basada en Marlin por USB (Ender 3, Prusa MK3, CR-10, etc.). No se necesita OctoPrint ni Klipper — solo un cable USB. Tipo: serial. |
Kiln incluye perfiles ajustados para 68 modelos de 15 marcas — Creality, Bambu Lab, QIDI, Elegoo, Prusa Research, Sovol, AON3D, Artillery, Voron, AnkerMake, FlashForge, INTAMSYS, RatRig, SparkX, Vision Miner. Ver la lista completa y buscable →
Arquitectura
graph TD
A["🤖 AI Agent<br/><sub>Claude · GPT · Custom</sub>"]
A -->|"CLI or MCP"| B["⚙️ Kiln<br/><sub>CLI + MCP Server</sub>"]
B --> C["🖨️ Your Printers"]
B --> F["🏭 Fulfillment"]
B --> D["🛒 Marketplaces"]
B --> V["📐 Designs (versioned)<br/><sub>Pro+</sub>"]
C --> E1["OctoPrint"]
C --> E2["Moonraker"]
C --> E3["Creality"]
C --> E4["Bambu"]
C --> E5["Prusa Link"]
C --> E6["Elegoo"]
F --> F1["Craftcloud"]
D --> I["MyMiniFactory"]
D --> J["Cults3D"]
V --> V1["Branches"]
V --> V2["Signed Releases"]
V --> V3["Cloud Sync"]
style A fill:#1a1a2e,stroke:#e94560,color:#fff
style B fill:#16213e,stroke:#0f3460,color:#fff
style C fill:#0f3460,stroke:#e94560,color:#fff
style F fill:#0f3460,stroke:#27ae60,color:#fff
style D fill:#0f3460,stroke:#533483,color:#fff
style V fill:#0f3460,stroke:#f59e42,color:#fff
style E1 fill:#2d2d44,stroke:#e94560,color:#fff
style E2 fill:#2d2d44,stroke:#e94560,color:#fff
style E3 fill:#2d2d44,stroke:#e94560,color:#fff
style E4 fill:#2d2d44,stroke:#e94560,color:#fff
style E5 fill:#2d2d44,stroke:#e94560,color:#fff
style F1 fill:#2d2d44,stroke:#27ae60,color:#fff
style I fill:#2d2d44,stroke:#533483,color:#fff
style J fill:#2d2d44,stroke:#533483,color:#fff
style V1 fill:#2d2d44,stroke:#f59e42,color:#fff
style V2 fill:#2d2d44,stroke:#f59e42,color:#fff
style V3 fill:#2d2d44,stroke:#f59e42,color:#fff
Los agentes también pueden externalizar trabajos a través del servicio de fabricación Craftcloud y buscar modelos en MyMiniFactory y Cults3D (solo búsqueda). En Pro y superiores, la propia tienda de diseño está versionada — ramas, lanzamientos firmados y sincronización en la nube entre máquinas son resultados de primera clase del sistema, no una base de datos secundaria.
Git para 3D
Los diseños no son texto, pero necesitan control de versiones. Kiln trata las mallas, decoraciones y características mecánicas como artefactos versionados de primera clase: ramifica un diseño, imprime variantes, fusiona lo que funciona, firma lanzamientos con prueba criptográfica de que la malla no ha cambiado.
Tres cosas hacen que esto sea diferente de git:
- Ramas correlacionadas con resultados. Cada rama está etiquetada con resultados de impresión empíricos — tasa de éxito, deformación, adhesión, costo — para que la comparación A/B entre ramas sea automática, no anecdótica.
- Fusión semántica de mallas en 3 vías. Las zonas de conflicto de nivel Z / bolsillo / cuadro delimitador se muestran como diferencias visuales, no parches de texto. Tolerancia de fabricación, no desplazamientos de caracteres.
- Lanzamientos firmados con re-impresión digital de la malla. Firmas Ed25519 sobre un manifiesto de lanzamiento anclado a una malla exacta; la verificación recalcula la huella digital para detectar manipulación después del lanzamiento.
Esto es lo que visualize_branch_tree("my-coaster") realmente emite — el mismo renderizador que ven el taller, la CLI y tu agente (amarillo = lanzamiento firmado, azul claro = experimento, rojo claro = rama con resultados fallidos):
flowchart TD
subgraph tree_coaster["📐 my-coaster · design"]
v0[v0: initial]
v1[v1: emboss-1mm<br/>83% success]
v2[v2: emboss-2mm<br/>92% success · warp 2%]
v3[v3: emboss-3mm<br/>warp 5%]
v4[v4: merge winner]
rel[🔏 1.0.0]
v0 --> v1
v0 --> v2
v0 --> v3
v2 --> v4
v4 --> rel
end
classDef root fill:#f3f4f6,stroke:#374151,color:#111
classDef released fill:#ffd60a,stroke:#111,stroke-width:3px,color:#111
classDef experiment fill:#e0e7ff,stroke:#6366f1,color:#1e1b4b
classDef failed fill:#fecaca,stroke:#b91c1c,color:#7f1d1d
class v0 root
class v1 experiment
class v2 experiment
class v3 failed
class v4 experiment
class rel released
style tree_coaster fill:#ffffff,stroke:#e5e7eb,stroke-width:1px
| Nivel | Qué obtienes |
|---|---|
| Gratis | Historial de diseño local lineal (guardar / comparar / revertir) |
| Pro | Ramificar · fusionar · selección selectiva · lanzamientos firmados Ed25519 · sincronización en la nube individual |
| Business | Solicitudes de extracción de equipo · puertas de aprobación · organizaciones / equipos / ámbitos |
| Enterprise | Exportación de registro de auditoría · SSO · autenticación reforzada en lanzamientos · revisión de accesos |
Patente pendiente en fusión semántica de mallas, ramificación correlacionada con resultados y lanzamiento firmado con procedencia física.
Herramientas
El servidor MCP de Kiln (kiln serve) expone 908 herramientas a los agentes, además de prompts y recursos para 915 capacidades MCP en total. En lugar de enumerarlas todas aquí, los agentes exploran el catálogo en vivo con get_skill_manifest y descubrimiento estilo ToolSearch. Una muestra representativa, en el orden en que ocurre una impresión real:
- design_session
- Habla con Kiln sobre lo que estás creando y recibe un diseño que coincida con lo que pediste
- La puerta de entrada para hacer cualquier cosa: objetivo, geometría, vista previa, iterar. Gratis, ilimitado, en todos los niveles
- compile_scad
- Compila código OpenSCAD en un STL imprimible — la ruta sin llave debajo de una sesión de diseño
- Sin clave de API y sin servicio externo: el agente escribe la geometría, Kiln la compila localmente
- generate_model
- Genera un modelo 3D a partir de un prompt de texto a través de un proveedor de IA externo
- Opcional y desactivado a menos que traigas tu propia clave (Meshy, Tripo3D, Stability, Gemini)
- search_all_models
- Busca en los mercados de modelos 3D conectados en una sola llamada
- Cubre MyMiniFactory y Cults3D; descargas donde el mercado lo permita
- import_step_file
- Importa un archivo CAD STEP (.step/.stp) y conviértelo para el pipeline de mallas de Kiln
- analyze_printability
- Ejecuta un análisis completo de imprimibilidad en una malla: voladizos, paredes delgadas, riesgo de deformación, ajuste en la cama
- auto_orient_model
- Encuentra la orientación de impresión que necesita menos soporte e imprime más resistente
- repair_mesh
- Repara defectos de malla — agujeros, caras degeneradas, costuras por ruido de redondeo
- La solución habitual para un modelo producido por un generador de IA o un escaneo aproximado
- split_mesh_to_fit
- Corta un sólido demasiado grande para tu placa de construcción en piezas imprimibles que se reensamblan
- recommend_material
- Recomienda materiales para un caso de uso, con las razones y las compensaciones
- decorate_surface
- Coloca cualquier imagen, texto, código QR o patrón en la superficie de un modelo como relieve o bajorrelieve
- slice_model
- Corta un modelo (STL/3MF/STEP) a G-code usando PrusaSlicer, OrcaSlicer o BambuStudio
- estimate_print_cost_from_mesh
- Estima el costo del material, el peso y el tiempo de impresión antes de comprometer la impresora
- preflight_check
- Ejecuta verificaciones de seguridad previas a la impresión: estado de la impresora, temperaturas, validez del archivo, espacio libre en la cama
- start_print
- Inicia una impresión en una máquina conectada
- monitor_print
- Estado de impresión de una sola vez: progreso, temperaturas, tiempo restante, costo y una instantánea de cámara donde la impresora tenga una
- emergency_stop
- Detiene una impresión en curso inmediatamente
- purge_filament
- Calienta la boquilla y empuja una longitud corta a través — la prueba de obstrucción, con
load_filamentyunload_filamenta su lado para un cambio de carrete - Informa lo que la impresora realmente pudo decir: en una Bambu lee el AMS y traduce el código de fallo propio de la impresora, y donde una máquina no informa señal de flujo lo dice en lugar de afirmar éxito
- Calienta la boquilla y empuja una longitud corta a través — la prueba de obstrucción, con
- diagnose_print_failure_live
- Diagnostica una impresión fallida a partir del estado en vivo de la impresora más la geometría del propio modelo
- retry_print_with_fix
- Diagnostica qué salió mal en la última impresión, luego vuelve a cortar e imprime con la corrección aplicada
- resume_interrupted_print (Pro)
- Reanuda una impresión interrumpida con una sola llamada en cualquier impresora FDM compatible
- save_design_version
- Guarda una nueva versión de un diseño paramétrico, para que puedas volver a la que funcionó
- El historial lineal es gratuito; ramificar, fusionar y lanzamientos firmados son Pro
- export_step
- Exporta un diseño terminado como un archivo CAD STEP real — B-rep analítico que un taller de máquinas puede abrir y medir
- fleet_status (Business)
- Estado en vivo de cada impresora en una flota: estado, temperaturas, conexión
- fulfillment_quote
- Obtén una cotización de fabricación de la red de Craftcloud — imprimir sin poseer una impresora
Más allá de esta muestra, el catálogo cubre orquestación de flotas, predicción de fallos de impresión, control de versiones de diseño, manuales de ensamblaje y calibración por máquina; los niveles más profundos se describen en kiln3d.com/pricing. El catálogo completo de herramientas, agrupado por subsistema, vive en Project Docs. Si eres el agente, kiln3d.com/agents cubre el mismo terreno escrito en segunda persona, incluyendo los rechazos que vale la pena conocer antes de encontrarlos.
Recursos MCP (contexto de solo lectura para agentes)
| URI del recurso | Descripción |
|---|---|
kiln://status | Instantánea de todo el sistema (impresoras, cola, eventos) |
kiln://printers | Listado de flota con impresoras inactivas |
kiln://printers/{name} | Estado detallado para una impresora específica |
kiln://queue | Resumen de la cola de trabajos y trabajos recientes |
kiln://queue/{job_id} | Detalle para un trabajo específico |
kiln://events | Eventos recientes (últimos 50) |
Capacidades
Buscar → descargar → imprimir. Kiln busca en MyMiniFactory y Cults3D (solo búsqueda) en una sola llamada vía search_all_models, descarga donde se admite y sube directamente a una impresora — un ciclo completo de diseño a impresión sin humano en el medio. (Thingiverse es compatible pero está en desuso desde su adquisición por MyMiniFactory en febrero de 2026; prefiere MMF.) El acceso al mercado usa claves API gratuitas (KILN_MMF_API_KEY, KILN_CULTS3D_USERNAME + KILN_CULTS3D_API_KEY).
Generación de modelos con IA. Configura cualquier clave de proveedor y está disponible al instante — KILN_MESHY_API_KEY, KILN_TRIPO3D_API_KEY, KILN_STABILITY_API_KEY, KILN_GEMINI_API_KEY — o usa OpenSCAD local sin clave. Las mallas generadas se validan automáticamente para imprimibilidad (variedad, recuento de triángulos, cuadro delimitador) antes de imprimir. kiln generate renderiza una vista previa de 3 vistas por defecto.
Corte. Envuelve PrusaSlicer, OrcaSlicer y BambuStudio para corte sin interfaz; detecta automáticamente los cortadores instalados en PATH, paquetes de aplicación macOS o vía KILN_SLICER_PATH. Admite STL, 3MF, STEP, OBJ, AMF con temperaturas conscientes del material y soportes inteligentes.
Fabricación (sin impresora requerida). Imprime a través de la red de Craftcloud — cotiza, valida dirección, confirma, ordena, rastrea — o ejecuta junto a tus propias impresoras para exceso de capacidad y materiales especiales. Los usuarios normales pasan por el proxy alojado (las credenciales permanecen del lado del servidor, se aplican límites de gasto); los operadores pueden usar el modo directo con KILN_FULFILLMENT_PROVIDER=craftcloud + KILN_CRAFTCLOUD_API_KEY.
Decoración y texturas. Graba en relieve o bajorrelieve códigos QR, fotos, logotipos, texto y SVG en cualquier cara del modelo, o aplica texturas procedimentales (rayas de tigre, mármol, camuflaje, veta de madera, panal) con una sola llamada de herramienta.
Precios
Toda la impresión local es gratis para siempre — estado, gestión de archivos, corte, control de flota e impresión en tus propias impresoras no cuestan nada. Kiln cobra una tarifa de orquestación del 5% en pedidos realizados a través de servicios de fabricación externos (los primeros 3 pedidos de cada mes calendario son gratuitos, en todos los niveles; mínimo $0.25 / máximo $200 por pedido), mostrada de forma transparente en cada cotización. El volumen de pedidos externalizados no tiene límite en ningún nivel.
| Nivel | Precio | Titular |
|---|---|---|
| Gratis | $0 | Impresión local ilimitada, corte, búsqueda en mercados, perfiles de seguridad, una impresora, inteligencia de diseño, historial de diseño lineal. |
| Pro | $49/mes | Ramificación/lanzamientos firmados de Git para 3D, plantillas de producto, texturas procedimentales, modificación a mitad de impresión, reanudación de impresión, recuperación de fallos, seguimiento de desgaste de boquilla, sincronización en la nube individual. |
| Business | $199/mes | Uso comercial, 3 impresoras + 3 asientos, gestión de flota, aprendizaje entre impresoras, generación de QR, manuales de ensamblaje, solicitudes de extracción de equipo, puertas de aprobación, webhooks. |
| Enterprise | Contáctanos | Flotas grandes, SSO/SCIM, RBAC, rastro de auditoría, G-code cifrado en reposo, manuales de marca blanca, SLA del 99.9%, on-prem/VPC. |
Comparación completa en kiln3d.com/pricing. Ejecuta kiln upgrade para activar una clave de licencia. Para pedidos enrutados por proveedor, el proveedor sigue siendo el comerciante de registro; Kiln actúa como infraestructura de orquestación.
Seguridad
Kiln es infraestructura que prioriza la seguridad para controlar máquinas físicas:
- Verificaciones previas al vuelo validan el estado de la impresora, las temperaturas y los archivos antes de cada impresión
- Validación de G-code bloquea comandos peligrosos (reinicio de firmware, temperaturas inseguras)
- Límites de temperatura aplican máximos seguros (300 °C hotend, 130 °C cama)
- Confirmación requerida para operaciones destructivas (cancelar, G-code crudo)
- Autenticación opcional con claves API basadas en ámbitos para configuraciones multiusuario
- Errores estructurados aseguran que los agentes siempre sepan cuándo algo falla
Paquetes
Este monorepo contiene dos paquetes:
| Paquete | Descripción | Punto de entrada |
|---|---|---|
| kiln | CLI + servidor MCP para control de múltiples impresoras (OctoPrint, Moonraker, Creality, Bambu, Prusa Link, Elegoo, USB directo) | kiln o python -m kiln |
| octoprint-cli | CLI independiente ligero para configuraciones solo con OctoPrint | octoprint-cli |
Desarrollo
# Create a virtualenv first (required on modern Ubuntu/Debian/WSL)
python3 -m venv .venv && source .venv/bin/activate
pip install -e "./kiln[dev]"
pip install -e "./octoprint-cli[dev]"
cd kiln && python3 -m pytest tests/ -v
cd ../octoprint-cli && python3 -m pytest tests/ -v
Ejecutar en Docker
docker compose up aloja el servidor MCP de Kiln contra tu propia impresora: configura KILN_PRINTER_TYPE/KILN_PRINTER_HOST/KILN_PRINTER_API_KEY primero. Esto es una guía rápida de autoalojamiento personal, sin relación con la infraestructura detrás del servicio alojado api.kiln3d.com. ¿Prefieres cero configuración? kiln3d.com ejecuta la versión alojada por ti.
Referencia de configuración (autenticación, webhooks, descubrimiento, plugins)
Autenticación (opcional)
Autenticación opcional por clave API para herramientas MCP, deshabilitada por defecto. Ámbitos: read, write, admin. Las herramientas de solo lectura nunca requieren autenticación.
export KILN_AUTH_ENABLED=1
export KILN_AUTH_KEY=your_secret_key
export KILN_MCP_AUTH_TOKEN=your_secret_key # clients provide their key here
Webhooks
Registra endpoints HTTP para notificaciones de eventos en tiempo real:
register_webhook(url="https://example.com/hook", events=["job.completed", "print.failed"])
Los payloads se firman con HMAC-SHA256 cuando se proporciona un secreto. Las redirecciones están bloqueadas por defecto (KILN_WEBHOOK_ALLOW_REDIRECTS=0); cuando están habilitadas, cada salto se valida contra SSRF y se bloquea la degradación HTTPS→HTTP.
Descubrimiento de impresoras
kiln discover # mDNS/Bonjour + HTTP subnet probing
Encuentra impresoras OctoPrint, Moonraker/Creality, Bambu, Elegoo y Prusa Link. Si el descubrimiento no devuelve nada, regístralas directamente por IP con kiln auth.
Plugins de terceros
Los plugins de punto de entrada están denegados por defecto en producción (KILN_PLUGIN_POLICY=strict). Permite plugins específicos con KILN_ALLOWED_PLUGINS=my_plugin,other_plugin, o establece KILN_PLUGIN_POLICY=permissive para compatibilidad temporal de migración.
Módulos (para colaboradores)
| Módulo | Descripción |
|---|---|
server.py | Servidor MCP con herramientas, recursos y cableado de subsistemas |
printers/ | Abstracción de adaptadores de impresora (OctoPrint, Moonraker, Creality, Bambu, Prusa Link, Elegoo) |
marketplaces/ | Adaptadores de marketplace de modelos (MyMiniFactory, Cults3D, Thingiverse, fuentes solo de metadatos) |
slicer.py | Integración de slicers (PrusaSlicer, OrcaSlicer, BambuStudio) con detección automática |
registry.py | Registro de flota para gestión de múltiples impresoras |
queue.py | Cola de trabajos prioritaria con seguimiento de estado |
scheduler.py | Despachador de trabajos en segundo plano con enrutamiento inteligente basado en historial |
events.py | Bus de eventos pub/sub con historial |
persistence.py | Almacenamiento SQLite para trabajos, eventos y configuraciones |
webhooks.py | Entrega de webhooks basada en eventos con firma HMAC |
auth.py | Autenticación opcional por clave API con acceso basado en ámbitos |
discovery.py | Descubrimiento de impresoras en red (mDNS + sonda HTTP) |
generation/ | Proveedores de generación de texto a modelo (Meshy, Tripo3D, Stability AI, Gemini Deep Think, OpenSCAD) con autodescubrimiento, validación de mallas y análisis de imprimibilidad |
consumer.py | Flujo de trabajo para consumidores no impresores (validación de direcciones, recomendaciones de materiales, estimación de cronograma/precio, incorporación) |
cost_estimator.py | Estimación de costos de impresión a partir del análisis de G-code |
materials.py | Seguimiento de múltiples materiales y carretes |
material_catalog.py | Catálogo de marcas de materiales, propiedades y metadatos de enlaces de compra |
material_inventory.py | Inventario de materiales de flota y seguimiento de asignación |
bed_leveling.py | Sistema automatizado de activación de nivelación de cama |
streaming.py | Proxy de transmisión de webcam MJPEG |
cloud_sync.py | Sincronización en la nube para configuraciones de impresora e historial de trabajos |
plugin_loader.py | Descubrimiento y registro interno de tool-plugins |
plugins/ | Módulos de herramientas MCP enfocados cargados por el cargador de plugins |
gcode.py | Validador de seguridad de G-code con límites por impresora |
gcode_interceptor.py | Intercepción de G-code basada en reglas y reescritura de seguridad |
safety_profiles.py | Base de datos de seguridad incluida (51 modelos de impresora nombrados, temperaturas/velocidades de avance/flujo) |
slicer_profiles.py | Perfiles de slicer incluidos (genera automáticamente archivos .ini por impresora) |
printer_intelligence.py | Base de conocimiento de impresoras (peculiaridades de firmware, materiales, modos de fallo) |
pipelines.py | Pipelines de impresión prevalidados (quick_print, calibrate, benchmark) |
assembly.py | Validación de ensamblaje multiparte y soporte de planificación manual |
design_versions.py | Historial de diseño local, registros de versiones, diferencias y primitivas de reversión |
mesh_validation_pipeline.py | Pipeline de validación de imprimibilidad de múltiples puertas |
model_visualizer.py | Renderizado de vista previa de modelos local |
tool_schema.py | Conversor de esquema de llamada de funciones de OpenAI (MCP → formato OpenAI) |
tool_tiers.py | Definiciones de niveles de herramientas (esencial/estándar/completo) para coincidencia de capacidades de modelos |
agent_loop.py | Bucle de agente genérico para cualquier API compatible con OpenAI (OpenRouter, directo, etc.) |
openrouter.py | Integración de OpenRouter con catálogo de modelos y detección automática de niveles |
data/ | Bases de datos JSON incluidas (perfiles de seguridad, perfiles de slicer, inteligencia de impresoras) |
gateway/ | Puerta de enlace de integración de proveedores externos (a medida que se lancen integraciones) |
heater_watchdog.py | Vigilante de autoenfriamiento para calentadores inactivos |
wallets.py | Configuración de billetera cripto (Solana/Ethereum para donaciones y tarifas) |
pro_tool_manifest.json | Manifiesto público para descubrimiento de herramientas kiln-pro y stubs de proxy REST |
decoration_quota.py | Seguimiento de cuota de decoración de nivel gratuito y enlaces de resolución de niveles |
cli/ | CLI de Click con 242 comandos y salida JSON |
kiln-pro (kiln3d.com) extiende Kiln público con servicio REST de nivel de pago, facturación, licencias, SSO, RBAC, cifrado de G-code, informes de tiempo de actividad, administración de equipos y flujos de trabajo de costos de proyectos. Kiln público expone solo la superficie de interfaz/proxy para esas capacidades; la implementación privada permanece en kiln-pro.
Documentación
| Documento | Descripción |
|---|---|
| Documentación del proyecto | Referencia completa (CLI, herramientas MCP, adaptadores, configuración) |
Recursos de marca
Los archivos de logotipo viven en docs/assets/ — todo SVG vectorial, escalable a cualquier tamaño.
| Archivo | Uso |
|---|---|
kiln-banner-1280x640.svg / kiln-banner-1280x640-light.svg | Banner de GitHub / redes sociales (esquema oscuro / claro) |
kiln-logo-dark.svg / kiln-logo-light.svg | Marca principal + logotipo de palabra (fondo oscuro / claro) |
kiln-horizontal-dark.svg / kiln-horizontal-light.svg | Composición horizontal (fondo oscuro / claro) |
kiln-logo-dark-notext.svg | Solo marca (fondo oscuro) |
kiln-favicon-256.svg | Favicon / icono de aplicación |
kiln-logo-transparent.svg / kiln-logo-transparent-dark.svg | Fondo transparente (para UIs oscuras / claras) |
kiln-mark-1024.svg | Mosaico de marca cuadrado — foto de perfil, mosaico de aplicación (1024×1024) |
kiln-x-header-1500x500.svg | Encabezado social (1500×500) |
wallpapers/kiln-wallpaper-iphone-*.svg | Fondos de pantalla para iPhone |
wallpapers/kiln-wallpaper-macbook-*.svg | Fondos de pantalla para MacBook |
Cada archivo anterior se genera a partir de una sola geometría, por lo que la marca es idéntica en todos ellos. Por favor, no la redibujes: escala el vector en su lugar.
Apoya el desarrollo
Kiln es software libre y de código abierto. Si te resulta útil, considera enviar una propina:
- Solana:
kiln3d.sol - Ethereum:
kiln3d.eth
Posicionamiento
Aclaración de mensajería (24 de febrero de 2026): Aclaramos la redacción para eliminar ambigüedad y alinearnos con la intención existente; sin cambio de estrategia. Kiln es infraestructura de orquestación y agentes para flujos de trabajo de fabricación. Kiln no opera un marketplace/red de fabricación descentralizada de primera parte. Kiln se integra con proveedores de terceros y adaptadores de proveedores/redes externos a medida que las integraciones estén disponibles.
No objetivos: operar un marketplace/red de fabricación descentralizada de primera parte; reemplazar redes de suministro de socios; poseer marketplaces de proveedores en lugar de integrarse con ellos; actuar como comerciante de registro para pedidos de fabricación enrutados por proveedores.
Licencia
Kiln es un proyecto de Hadron Labs Inc.
Licencia AGPL-3.0 — código abierto con copyleft. Licencias comerciales disponibles para empresas que necesiten uso propietario.
Al contribuir, aceptas el Acuerdo de Licencia de Colaborador.
También listado en Smithery.