# Kiln

Kiln is an open-source local engine for creating editable 3D assets from JavaScript.
It provides a CLI, MCP tools, a TypeScript library, and project-local agent skills.
Outputs include GLB files, rendered views, structural checks, and reusable source revisions.
Your coding harness supplies the model. The tools do not require a separate model API key.

## Start here

- Website and examples: https://kilnstudio.tools/
- ChatGPT connection, interactive chat viewing, skills, and download limits: https://github.com/matthew-kissinger/kiln/blob/main/docs/chatgpt.md
- Saved collections, revisions, local viewer, and editable bundles: https://github.com/matthew-kissinger/kiln/blob/main/docs/collections.md
- Repository: https://github.com/matthew-kissinger/kiln
- Installation: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/install.md
- Project-local setup: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/clean-room.md
- Tool schemas: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/tools.md
- Source revisions: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/programs.md
- Geometry: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/geometry.md
- Cameras and part-relative views: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/cameras.md
- Rendering and fidelity: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/rendering.md

## Authoring workflow

Read the generated project's AGENTS.md and START.md and its installed skills.
Discover the connected host's capabilities with kiln_list_primitives({capabilities:true}).
Read the actual tool schemas before calling tools; do not infer helper signatures.
Submit new source once. Reuse the returned programRef for source reads, edits and renders.
Copy it exactly: built-in stores return short immutable handles such as p_7c94a132b8e0.
Do not construct or shorten references yourself. Full sha256 references remain accepted.
Keep the workspace store and its mappings for reuse across CLI calls and MCP restarts.
kiln_source returns bounded source text. kiln_edit applies exact replacements and returns
an immutable new revision. Do not rewrite the entire program just to pass it to another tool.
Inspect whole-asset views and relevant part views. Check errors and image fidelity metadata.
CPU views show geometry and base colours; use the optional GPU renderer for PBR material review.
Export both accepted source and GLB. Keep model attribution and actual render provenance.

## Skills

- Author: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/skills/kiln-author-asset/SKILL.md
- Refine: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/skills/kiln-refine-asset/SKILL.md
- QA: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/skills/kiln-qa-asset/SKILL.md

## Development and examples

- Architecture: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/architecture.md
- Extending the engine: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/extending.md
- Contributing: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/CONTRIBUTING.md
- Example source and credits: https://raw.githubusercontent.com/matthew-kissinger/kiln/main/docs/examples.md
- Gallery manifest, including source and GLB paths: https://kilnstudio.tools/assets/index.json

This file is a reading index. The linked registry-generated reference and the connected
host's capabilities describe the API. The gallery is curated work, not a model benchmark.