需 Node.js 22 或 24 LTS 与 npm，Bun 仅用于开发 Kiln 本身；作者工作区要与引擎安装目录分开；材质保真渲染依赖可选的本地渲染服务，纹理与金属外观需对照报告的保真度检查。
kiln
instruktlabsMIT活跃维护让编码智能体通过本地 MCP 服务、CLI 和 TypeScript 引擎程序化生成并迭代 3D 资产，支持渲染预览、源码编辑和 GLB 导出。
Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.
v1.7.0发布于 2026-11-08 15:08 UTC324star +6 / 7 天36fork同步于 2026-11-11 00:00 UTC
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 硬件要求按 README 说明
README 未说明显存或 GPU 型号要求；CPU 渲染无需 GPU，可用于几何审查，材质保真视图需可选的本地渲染服务。
纯 CPU 可运行
让编码智能体用 JS 写程序化 3D 资产，本地渲染审查并导出 GLB
让编码智能体通过本地 MCP 服务、CLI 和 TypeScript 引擎程序化生成并迭代 3D 资产，支持渲染预览、源码编辑和 GLB 导出。
核心能力
- 智能体写 JS 调用几何与材质辅助函数生成资产
- 返回多视角渲染图与结构检查供审查
- 保留可编辑源码与不可变修订历史
- 通过 MCP、CLI 和 TypeScript SDK 本地运行
- 导出 GLB 并支持本地资产库复用
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v1.7.0Kiln 1.7.0最新正式版2026-11-08 · 2026-11-08 15:08 UTC
Kiln 1.7.0 moves to three.js r187 and makes
kiln_renderandkiln_inspectmuch faster on large assets.three.js r187:
- three and
@types/threeare 0.187.0 in the package, the render service, the website and the scenes. CPU views and exported GLBs are byte-identical to 0.186.1 output apart from lathe normals in the last bit. - GPU views brighten slightly through r187's environment prefilter, most on metals;
review-neutral-v1keeps its id and values. The render service's build identity names 0.187.0, so a 1.7.0 host reports a 0.186.1 service as incompatible (kiln service stopends it).
Render speed:
- Calls on an artifact the host already loaded skip the load. The host review scene is reused across calls, within a byte cap, and long host steps no longer hold up other work.
- Camera-only
shotsinkiln_render,kiln_editandkiln_inspect, and CPU views, are drawn from the artifact itself, without exporting a derivative. - A review shot no longer exports the same derivative GLB, or decodes the same frame, more than once. Camera bounds, GLB decode and the integration manifest allocate less on large assets.
Export and materials:
kiln export ... --profile runtime --draws minimal [--draw-cell M]batches a runtime GLB down to its fewest draws, and GPU instancing draws what the copies drew.- The GPU render service samples the UV set a texture names, with its
KHR_texture_transform. - Procedural materials gain a periodic cellular (Worley/Voronoi) layer,
generatedmap sources and recorded parent revisions. kiln_exporttakes aprogramRef, so a destination audit can read the built GLB before a save.
Diagnostics:
- A build over the evaluator's output budget names the budget it reached,
KILN_EVALUATOR_TIMEOUT_MSworks above 60 seconds, and a missing evaluator worker names the rebuild.
The attached archive is the exact package published to npm as
@instruktlabs/[email protected]from release run 42490429680 (source33274ed4), with npm provenance. See SHA256SUMS for its digest and CHANGELOG.md for the full change list. - three and
- v1.6.0Kiln 1.6.02026-10-27 · 2026-10-27 20:31 UTC
查看更新说明
Kiln 1.6.0 adds texture-sharing tools, open-surface QA and clearer size and budget diagnostics.
Export and delivery:
kiln_export_totakestextures: 'manifest'; the runtime sidecar gainstextures[]naming each embedded image bysha256and mime type so a destination can share one copy across assets.kiln textures <files-or-folders>reports the texture duplication a delivered set ships. Library export:textureSharingReportfrom@instruktlabs/kiln/asset-export.- The delivery contract explains how to read a Kiln GLB without a DOM, and
defineBudgetaccepts zero material caps (images: 0,decodedBytes: 0).
QA and authoring:
GEO_OPEN_SURFACE_PENETRATIONmeasures open surfaces (cloth, canopies, cards) against the closed solids they meet. It is an observation, not a verdict.- Every material helper takes an optional
namewritten to the exported glTFmaterials[].name;remapUVToAtlastakes an optionalaxes. - The floating-parts warning and part-connectivity observation state their coverage, and the
drawscap states its pass scope.
Diagnostics:
- A program between the 1 MiB store limit and the 512 KiB evaluator transport is named as the size problem it is, at validate and edit time and before the request leaves the host.
The attached archive is the exact package published to npm as
@instruktlabs/[email protected]from release run 40571504293 (sourceb1df057d), with npm provenance. See SHA256SUMS for its digest and CHANGELOG.md for the full change list. - v1.5.0Kiln 1.5.02026-10-25 · 2026-10-25 18:11 UTC
查看更新说明
Kiln 1.5.0 collects the remaining fixes and features from the Holodeck dogfood pass.
Runtime export:
--max-lod Non the three runtime target keeps LOD0..LODN of eachMSFT_lodchain and records what it dropped.--position-bits 8..16|floatsets position quantization, and the sidecar reports the grid step.- Budget receipts add an informational instanced-draw estimate beside the
drawscap.
Authoring:
seededRandom(seed)for reproducible variation.simplifyGeometryderives a lower-detail copy of a part for an LOD tier.- Cylindrical
projectUVhandles poles, and profile solid failures reportPROFILE_SOLID_FAILEDwith advice. - A saved material's maps export as tiling textures with a planar preview.
Receipts and QA:
- Material measurements are advisory notes against a reference tier, never an undeclared budget.
defineBudgetcan declare binding material limits. - Saves report geometry deltas against the parent revision.
- The delivery contract explains every delivery finding, its tolerance and disposition.
CLI, setup and guidance:
kiln --version.- Generated Codex workspaces forward
KILN_EXPORT_ROOT. - Docs list the sandbox globals and the export weld rule.
- Guidance covers optional SDK setup, scene receipt refresh and profile-solid UVs.
The attached archive is the exact package published to npm as
@instruktlabs/[email protected]from release run 40206413793. See SHA256SUMS for its digest and CHANGELOG.md for the full change list. - v1.4.0Kiln 1.4.02026-10-23 · 2026-10-23 13:09 UTC
查看更新说明
Kiln 1.4.0 collects the fixes and features from a dogfood pass that built Holodeck scenes with Kiln.
Delivery and export:
kiln_export_to, an opt-in MCP tool for writing a saved revision under a host'sKILN_EXPORT_ROOT.- A runtime texture manifest, content-addressed external textures, and KTX2 encoding through the optional
[email protected]peer. - The three runtime target can now run without Meshopt (
--compression none). - The default converter now keeps vertex colours, author attributes and a second UV set.
- Non-unit normals are normalised on export, with a note naming the part.
QA and requirements:
- A host validation profile (
requirements.validation) for destination-specific glTF facts. externalSupportdeclarations for parts that rest on a neighbouring module.- Optional material-merge advice.
Authoring:
repeatAlongCurveand foliage helpers.- Metric
projectUV. - Normal maps derived from V3 height recipes; V3 stamps now accept every usage.
- Two new sets of material presets.
- Named diagnostics for procedural texture usage, with
kiln validateon the CLI. - Rule names in material validation errors.
- Partial Discovery results when some IDs are unknown.
- Read-only renderer status.
- A configurable compaction handoff path.
The attached archive is the exact package published to npm as
@instruktlabs/[email protected]from release run 39953274211. See SHA256SUMS for its digest and CHANGELOG.md for the full change list. - v1.3.1Kiln 1.3.12026-10-22 · 2026-10-22 04:28 UTC
查看更新说明
Kiln 1.3.1 is a maintenance release over 1.3.0. Authoring, review and export behavior are unchanged.
- Private security reporting is documented, and the policy ships in distributed packages.
- Codex plugin website and repository metadata are complete, and monthly dependency update proposals are configured.
- Installation instructions reference the published 1.3.0 plugin.
- Cabin gallery assets use single-view posters on the website.
The attached archive is the exact package published to npm as
@instruktlabs/[email protected]from release run 39085568303. See SHA256SUMS for its digest and CHANGELOG.md for the full change list.
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
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
Made with Kiln
Holodeck provides the runtime for Meridian Sanctuary, Crescent Cove and Winter Mountainside Cabin; Kiln provides their editable assets and GLBs. Golden Gate is one of the bundled interactive scenes.
Editable assets: Meridian (53) · Crescent Cove (49) · Winter Cabin (56) · Golden Gate bridge.
Explore all scenes or browse the asset gallery. To make your own, see text to 3D with your coding agent: a walking mech and a cathedral, prompt to GLB. Scene code and asset content retain their own licences; each pack records its scope.
From asset to scene
One timber wall becomes part of a modular cabin kit. Assemble its floors, walls and roof, furnish the kitchen and living room, then build the staircase, sleeping loft, bed and desk. The finished Winter Mountainside Cabin sits in a snowy Holodeck world.
The assembly visualizes the saved Kiln modules; the final view is captured in Holodeck. Both use WebGPU rendering.
Used in live games
I build Sheepdog Sim, OBJEKT 62 and ski sim alongside Kiln, and use these games to test Kiln-authored assets in real gameplay.
| Sheepdog Sim | OBJEKT 62 | ski sim |
|---|---|---|
 |  |  |
Sheepdog Sim's source shows how its Kiln-authored buildings, fencing and trees fit into a working game. OBJEKT 62 uses Kiln for weapons, vehicles and outpost modules; ski sim uses it for skiers, vegetation, village buildings and park equipment.
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.
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
KTX2 texture compression for the three.js runtime export (export --target three --ktx2)
uses an optional peer that Kiln does not install or bundle. Add it to the same installation
when you need it: npm install [email protected]. It is MIT-licensed and ships its own
notice for the bundled Basis Universal encoder (Apache-2.0); see
KTX2 textures.
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.
Hosted Kiln is a remote MCP server at
https://kiln.instruktlabs.com/mcp, open by invitation (see
Community and hosted access); it signs in through
OAuth with Google or GitHub. 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:runtime
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.