Frequently Asked Questions

Kiln is open-source infrastructure that lets AI agents design new objects, discover existing models, and autonomously slice, print, and monitor 3D printers. It exposes 836 MCP capabilities (Model Context Protocol), so any compatible AI agent can run full print workflows with safety guardrails built in. Describe what you want or upload a sketch, and Kiln handles everything from generation to the finished print. Think of it as the intelligence layer between an idea and a physical object.

OctoPrint and Moonraker are great printer management interfaces built for humans. Kiln sits on top of them and brand-specific paths like Creality, Bambu Lab, Elegoo, and Prusa Link to provide a unified, AI-friendly interface. It adds safety guardrails, job queues, slicing integration, and a standardized protocol — things you need when an autonomous agent is in the loop, not a person clicking buttons. Multi-printer fleet workflows are Business and Enterprise features.

Kiln is orchestration infrastructure for agents — it does not operate its own marketplace or manufacturing network. Instead, Kiln searches third-party model marketplaces (MyMiniFactory, Cults3D) and routes fulfillment orders to third-party providers (like Craftcloud). The provider remains merchant of record for any outsourced orders. See the product boundary page for a direct comparison.

Local printing is free forever — unlimited prints on 1 printer, no strings attached. Pro is also single-printer and personal-use focused. Business adds 3 printers included, team seats, commercial use, and fleet workflows; Enterprise is for larger custom deployments. See the pricing page for details.

Yes. Kiln is fully open source under the AGPL-3.0 license. You can self-host, modify, and contribute. Commercial licensing is available for companies that need proprietary use. The source code is on GitHub.

Kiln supports printers running OctoPrint, Moonraker (Klipper) — including Voron, RatRig, Sovol, and other Klipper builds — Creality K1/K2/Hi/Ender V3 KE-class printers when local Moonraker is reachable, Bambu Lab (X1C, X1E, P1S, P1P, P2S, A1, A1 Mini, A2L, H2S), Elegoo (Centauri Carbon, Saturn, Mars via SDCP; Neptune 4 and OrangeStorm Giga via Moonraker), Prusa Link (MK4, XL, Mini+), and any Marlin-based printer over USB (Ender 3, CR-10, Prusa MK3, etc.). Tuned per-model profiles cover dozens of models across a dozen brands — find yours on the supported printers page. Creality printers that do not expose local Moonraker can still use OctoPrint or Direct USB when those paths are available.

Install via pip: pip install kiln3d, then kiln signin (free account) and kiln install-mcp — it finds Claude Desktop, Claude Code, and Codex and wires Kiln into their configs automatically. Using a different MCP client? kiln install-mcp --print emits the config to paste. Full instructions are on the install page.

Any AI agent that supports the Model Context Protocol (MCP) can use Kiln — including Claude (via Claude Desktop or Claude Code), custom agents built with the OpenAI API, and any MCP-compatible client. Kiln also provides a REST API and CLI for non-MCP integrations.

MCP (Model Context Protocol) is an open standard for connecting AI agents to external tools and data sources. You don't need to understand MCP internals to use Kiln — just configure your AI agent to connect to the Kiln MCP server. If you're building custom agents, the docs cover the integration details.

Yes. Kiln includes a full command-line interface with 223 CLI commands and a REST API. You can manage printers, queue jobs, slice files, and run print operations entirely from the terminal or your own scripts — no AI agent required.

Yes — Kiln ships a git-style version control system for 3D designs. Every edit becomes a commit, branches let you iterate in parallel, three-way merges catch conflicts at the mesh level (not just file bytes), and Ed25519-signed releases prove exactly which version of a design shipped (tamper-evident for FDA 21 CFR 820.70 / AS9100 / ISO 13485 handoffs). Works on three artifact types: designs (your mesh), decorations (textures, logos, photo-emboss), and mechanical features (chamfers, fillets, pockets, holes, bosses, ribs). Runs fully offline; Pro+ adds cloud sync for multi-device access. FDM-focused today.

Your shell can't find the kiln binary. Add ~/.local/bin to your PATH by running pipx ensurepath, then restart your terminal. If you installed with pip into a virtualenv, make sure the virtualenv is activated.

Python 3.10 or newer. Check with python3 --version. If you're below 3.10, install via Homebrew (brew install python@3.12), apt (sudo apt install python3.12), or pyenv.

Yes. Kiln runs natively on Windows — install Python 3.10+ from python.org (or via winget install Python.Python.3.12) and then pip install kiln3d. macOS, Linux, and Windows are all first-class. Some users prefer WSL 2 for a more Unix-like shell experience, and Kiln runs fine inside WSL too — but it's not required. If mDNS printer discovery is flaky on your Windows LAN, connect to your printer by IP address (kiln auth --host http://192.168.1.x:port --type octoprint --api-key YOUR_KEY).

WSL 2 uses NAT networking, which blocks mDNS (Bonjour) discovery. Connect to your printer by IP address instead:
kiln auth --name my-printer --host http://192.168.1.x:port --type octoprint --api-key YOUR_KEY
Works for Ethernet and Wi-Fi LAN setups.

Yes — Kiln works over LAN IP, so Ethernet-only printers are fully supported. If kiln discover doesn't find your printer (firewall, mDNS blocked, etc.), register it directly by IP:
kiln auth --name my-printer --host http://192.168.1.x:port --type prusalink --api-key YOUR_KEY

Kiln auto-detects PrusaSlicer and OrcaSlicer on your PATH and in standard macOS app bundle locations. If yours is installed somewhere unusual, point at it explicitly:
export KILN_SLICER_PATH=/path/to/prusa-slicer

Kiln tells you when a new version is out — through your AI assistant or in the CLI — so you won't miss one. To upgrade, run kiln self-update (or pip install --upgrade kiln3d). Kiln never updates itself automatically, and you can turn the check off with KILN_NO_UPDATE_CHECK=1.

If you used pipx: pipx uninstall kiln3d
If you used pip: pip uninstall kiln3d
If you used the one-line installer: ~/.kiln/src/install.sh --uninstall

Kiln is built around the principle that AI should never have unchecked access to hardware. Every print operation passes through a safety layer that enforces per-printer temperature limits, validates G-code commands, runs pre-flight checks before prints, and blocks dangerous operations. Safety profiles cover popular printer models with manufacturer-specific limits.

Kiln enforces multiple layers: per-printer temperature and speed limits from a validated safety profile database, G-code command validation that blocks unsafe operations, real-time G-code interception for in-flight filtering, mandatory pre-flight checks before every print, and structured error handling that never silently fails.

Kiln is local-first: your designs, G-code, printer credentials, and print files stay on your network, and printer control never requires an account. The cloud touches that exist are explicit and controllable — a version-update check (disable with KILN_NO_UPDATE_CHECK=1), anonymized print-outcome sharing that improves community learning (success/failure signals, never your designs or files; controlled via Kiln's telemetry preferences), connections you configure yourself like marketplace search and fulfillment, and signed-in features you choose to use, like cloud sync and your stats dashboard.

Yes. Kiln supports tool tiers (essential, standard, full) that control which MCP tools are exposed to the agent. You can restrict agents to read-only monitoring, allow standard print operations, or grant full access including fleet management and raw G-code — depending on your trust level.

Yes, with the right tier. Free and Pro each support 1 printer. Business includes 3 printers, with additional printers available up to 50. Enterprise is custom-quoted for larger fleets.

Yes. Kiln integrates with PrusaSlicer and OrcaSlicer for local slicing, with bundled slicer profiles optimized per printer model. You can also use pre-sliced G-code files. The AI agent can trigger slicing, adjust settings, and go from STL to print in a single conversation.

Yes. Kiln routes orders to third-party fulfillment providers — currently Craftcloud — through the hosted fulfillment path or direct mode with your own provider credentials. Your AI agent can compare quotes from 150+ third-party print services across FDM, SLA, SLS, MJF, and metal, select materials, and place orders through the same interface used for local printing. Kiln does not operate its own manufacturing network — it orchestrates the workflow while the third-party provider remains merchant of record.

Yes. Kiln searches third-party model marketplaces — MyMiniFactory (search + download, works out of the box), Cults3D (search only, requires your own API key), and Thingiverse (deprecated). Your AI agent can discover existing models, download from supported sources, and send them to your printer in one workflow.

Yes. Kiln includes a priority job queue with scheduling, so you can queue up multiple prints with different priorities. The scheduler dispatches jobs automatically as printers become available, and you can build fully automated pipelines using the pre-validated print pipeline system (quick_print, calibrate, benchmark).

Yes. Kiln supports text-to-3D generation via Gemini Deep Think, Meshy, Tripo3D, and Stability AI, plus parametric code-as-CAD generation via OpenSCAD. You can also upload a napkin sketch for image-to-3D conversion. Providers are auto-discovered from environment variables — just set your API key and Kiln finds it.

Design Intelligence is Kiln's engineering knowledge base — 25 FDM materials with full mechanical/thermal/chemical properties, 45 brand-specific filament profiles, 18 proven design templates (snap-fits, living hinges, threads, press-fits), and structural load estimation. When you describe what you want to print, Kiln uses this knowledge to select the right material, apply proven patterns, and validate that the design will actually work before generating geometry.

Before any model reaches your slicer, Kiln analyzes it across 7 dimensions: overhang detection, thin wall analysis, bridging assessment, bed adhesion estimation, support volume calculation, warping risk, and thermal stress. It scores models 0-100, recommends optimal print orientation, and suggests adhesion settings (brim/raft) based on the geometry, material, and your specific printer.

Yes. The assembly module validates clearances between parts, detects joint types (snap-fit, press-fit, threaded, adhesive), checks tolerance stacking, and plans splits for models that exceed your build plate. Free tier supports up to 10 parts per assembly.

Yes. Multi-part prints with Kiln Business auto-generate a printable PDF assembly manual alongside the slice — Bill of Materials, isometric per-step renders, mating-direction arrows, and pause-and-check verification gates. Business ships co-branded covers (your name on the cover, 'Powered by Kiln' in the footer), multilingual single-PDF output (English / German / French / Spanish / Italian sections in one document), and 'what changed' diff manuals — when you ship v1.3 of a kit, buyers of v1.2 get a 5-page diff PDF instead of a 60-page rebuild. Enterprise adds factory work instructions (procurement part numbers, per-step torque, inspection sign-off, document control), full white-label, plus a free buyer-side authenticity verifier so customers can confirm the PDF is the one you signed.

Kiln calculates the cost of any print before it starts — material cost (by weight and filament type), electricity, and time. It also provides smart recommendations: cheaper filament alternatives that maintain strength, speed profiles that save time, and quality tradeoffs. Use it to budget projects or compare local vs outsourced manufacturing costs.

Yes. Kiln's multi-modal decoration engine accepts photos, logos, text, SVGs, and brand assets and converts them into embossed or debossed surface features with one command. Free users get 3 decorations per month; Pro unlocks unlimited. Scannable QR codes are a Business-tier feature — they require multicolor printing on Bambu AMS for reliable scanning, and the typical use case (product labels, merch, packaging, inventory tracking) sits above the solo-creator band. The engine handles surface intelligence automatically — it knows which face of a coaster or jewelry tray to decorate and at what depth.

Procedural textures are algorithmically generated surface patterns — tiger stripe, marble, digital camo, snakeskin, wood grain, carbon fiber, honeycomb, lava, and more — that Kiln applies directly to any 3D model for multicolor FDM printing. No UV mapping or texture software needed. Each texture generates the correct AMS color assignments automatically. This is a Pro feature.

Yes. Kiln Pro includes product templates for coasters, keychains, ornaments, pet tags, pet bowls, bookmarks, fridge magnets, jewelry trays, wall plaques, and ashtrays. Say "make me a coaster with my logo" and Kiln generates the geometry, places the decoration, picks the right colors, and prepares the file for print — including multicolor if your printer has an AMS.

Yes. Kiln Pro's mid-print modification engine can decorate, add geometric features, or swap materials on a live print — without cancelling and restarting. If the modification goes wrong, an atomic revert path restores the original job. Works across all supported FDM printers.

With Kiln Pro, you don't lose the partial print. The resume system picks up from the exact layer where the print stopped — generating a safe resume sequence that avoids crashing the nozzle into the partial object on the bed. Works on Bambu Lab, OctoPrint, Moonraker/Klipper, Creality when exposed through Moonraker, Prusa Connect, Elegoo, and Serial printers.

Yes. Kiln records print outcomes (success, failure, quality grade) and correlates them with the material, printer, settings, and design version used. Over time, it recommends better settings for the same material + printer combination, predicts failure risk before you start, and detects design regressions when a model that used to print well stops working. Pro includes single-printer print learning. Cross-printer learning is a Business and Enterprise fleet feature.

Yes. Kiln auto-detects AMS trays, identifies loaded filament colors and types, and routes the correct AMS slot when starting a print. For multicolor prints, Kiln handles automatic color segmentation and multi-gcode merging. On an AMS 2 Pro or AMS HT, Kiln can also run the dryer — start or stop a drying cycle and check filament humidity and time remaining — free for everyone. Use ams_status() to check loaded materials and slice_and_print for automatic AMS routing.

Yes — Kiln Pro watches nozzle wear across every print on every supported printer. It warns before a job would push the nozzle past its wear limit, flags abrasive-filament mismatches up front (carbon-fiber on a brass nozzle gets a heads-up), folds wear into failure diagnosis, and recommends a nozzle replacement when that's the real fix instead of another retry.

Kiln stops it before it starts. If a part won't fit your build plate — or calls for a material your hotend can't melt — Kiln catches it before any filament is wasted or the nozzle crashes. It rotates the part to fit when that solves it, never blocks a print it isn't sure about, and there's a one-command override for when you're deliberately slicing for a different printer. That protection is free for everyone; Kiln Pro adds the fix — your printer's true usable area, the cleanest way to split an oversize part, or the material to switch to.

Yes — ask about the exact liquid or exposure you have in mind and Kiln answers honestly, including the part most people miss: 3D-printed parts take chemicals harder than solid plastic does. The warnings are always free — if it's a bad idea, Kiln says so on any tier. The go-aheads are paid: everyday exposures (cleaners, oils, sunlight, weather) are Kiln Business, and answers someone could get hurt by — fuels, automotive fluids, food contact, harsh chemicals — are Enterprise.

Yes, on Kiln Business. Import the material's datasheet and Kiln designs with your material's real numbers instead of the closest built-in match.

Python. Kiln is distributed as two pip-installable packages: kiln3d (the MCP server) and octoprint-cli (standalone CLI tool). Both use modern Python with full type hints, dataclasses, and async support.

Yes. Kiln uses an abstract adapter interface (PrinterAdapter) that any new printer backend can implement. If your printer has a REST, MQTT, WebSocket, or serial API, you can write an adapter that normalizes it to Kiln's standard interface. See the existing adapters (OctoPrint, Moonraker, Creality, Bambu, Elegoo, Prusa Link) as reference implementations.

Fork the repo, create a branch, and submit a pull request. Kiln uses pytest for testing (19,467 tests across both repos), Ruff for linting, and follows strict patterns documented in the contributing guide. Issues and feature requests are welcome on GitHub.