Kiln
Build and revise 3D assets with your coding agent.
Your agent writes JavaScript using Kiln's geometry and material helpers. Kiln runs the program, returns rendered views and structural checks, and exports a GLB. Keep the editable source to refine the asset later.
Kiln runs locally through MCP, the CLI or a JavaScript/TypeScript SDK. It is free, open source and account-free. Your coding agent supplies the model; Kiln's tools do not require a separate model API key.
Documentation · Gallery · Interactive scenes · Changelog
Community and hosted access
Join the Kiln Discord to share assets, get help,
and request hosted access. Hosted Kiln is open
as a free, invite-only introductory service, with ten accounts sharing an
allowance of 200 native requests per month. Ask in #request-access or message
matt_941; individual Kiln codes are sent privately as capacity allows.
Joining Discord does not automatically grant hosted access. Local Kiln remains
free, open source and account-free.
| Cabin in the Woods: the cabin and woodland | Inside the cabin |
|---|---|
 |  |
Cabin in the Woods: PSX Horror includes 53 editable assets and a playable cabin and woodland scene.
| Troy: the city and fleet | Achilles and Hector at the gates |
|---|---|
 |  |
| Farm | Golden Gate |
|---|---|
 |  |
| Foundry Floor: the campus | Inside the fab |
|---|---|
 |  |
Play Troy, explore the Farm, drive across Golden Gate, or walk the Foundry Floor. The scenes combine Kiln assets with application code; their source and asset packs are available separately.
Six reusable vehicles, shown with the gallery's live body-paint controls:
| Hatchback | Sedan | SUV |
|---|---|---|
 |  |  |
| Pickup | Box truck | Transit bus |
 |  |  |
Install
Use Node.js 22 or 24 LTS and npm. See supported versions and platforms for the complete compatibility range. Bun is only needed to work on Kiln itself.
mkdir kiln-install
cd kiln-install
npm init -y
npm install @instruktlabs/kiln
npx --offline --no -- kiln-init ../my-assets --harness codex
cd ../my-assets
Open your coding agent in my-assets and follow START.md. Choose claude,
codex, opencode, agy, hermes, copilot or cursor-agent for --harness.
Setup creates project-local instructions, skills, launchers and a kiln_workspace
MCP connection. Keep this authoring workspace separate from the engine installation.
Then ask your agent for an asset:
Create a low-poly camping lantern with a carry handle. Review it from several angles, refine any problems, and save the editable source and a GLB.
For an existing project, Kiln 1.1+ supports a preview followed by adoption:
# Run from kiln-install; replace the path and harness for your project.
npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex --check
npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex
The preview writes nothing and exits 1 when changes are needed. Adoption preserves existing instructions and unrelated configuration, and reports conflicts before overwriting files. See installation and upgrades for version availability, additional agents, repairs and plugin setup.
What you can do
| Task | Kiln provides |
|---|---|
| Author and refine | Geometry helpers, named parts, immutable source revisions and anchored edits |
| Inspect | Multi-view renders, measurements and image-independent structural QA |
| Save and reuse | A local asset library, revision history and portable source/GLB exports |
| Review together | A local dashboard with materials, optional projects and Live Review |
| Integrate | Shared CLI/MCP tools and compiled ESM with TypeScript declarations |
Projects are optional. A single asset needs no pack, project record or hosted account. Use Discovery to find helpers rather than guessing API names.
CPU rendering works without a GPU and is useful for geometry review. Material-faithful views use the optional local render service; texture and metallic appearance must be checked against the reported fidelity. See rendering and materials. Experimental implicit modeling and the alternative Three.js exporter are opt-in; their stability boundaries are documented separately.
CLI and SDK
The package installs three commands: kiln, kiln-init and kiln-mcp.
For a command available throughout your terminal, install it globally:
npm install -g @instruktlabs/kiln
kiln discover --capabilities --json
kiln render my-asset.kiln.js --out my-asset.glb --views sheet.png
With a project-local installation, use npx --no -- kiln discover --capabilities --json
from that project. The CLI installation guide covers PATH
and the equivalent npm exec command.
Inside a generated authoring workspace, use its launcher to match the MCP server's Kiln installation, Node version and source store:
node kiln.mjs discover --capabilities --json
node kiln.mjs render my-asset.kiln.js --out my-asset.glb --views sheet.png
node kiln.mjs view
The SDK is available as @instruktlabs/kiln and documented subpaths.
Read the SDK guide for imports and host interfaces, and the
tool reference for MCP schemas. Local Claude Code and Codex
plugins use the same workspace
setup. Other MCP clients can connect directly.
ChatGPT uses a separate remote-connection setup. A public hosted Kiln service and vendor directory listings are not available yet.
Work on Kiln
For engine development, use the pinned toolchain:
git clone --filter=blob:none https://github.com/instruktlabs/kiln
cd kiln
bun install --frozen-lockfile
bun run build:sdk
node scripts/example-archive.mjs --fetch
bun run typecheck
bun run test
Read CONTRIBUTING.md for the complete checks, package builds and bug-report guidance, and AGENTS.md when changing the engine with an agent. Author assets in a separate workspace. Large scene downloads are optional and are not fetched by cloning the repository.
Kiln is maintained by Instrukt Labs and released under the MIT license. Downloaded asset packs carry their own licenses.