# codeofaxel/kiln architecture

> Architecture diagram of the GitHub repository codeofaxel/kiln, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codeofaxel/kiln
- Repository: https://github.com/codeofaxel/kiln

## Overview

Kiln is an MCP server and CLI for end-to-end 3D printing. The main user journey runs from an agent request through design and model validation, slicing and preflight, printer dispatch, then monitoring and recovery; service and marketplace features extend the workflow. The graph combines documented capabilities with sampled module references. Some major capability implementations were not sampled, so their internal connections are omitted rather than inferred.

Main entry points: [`kiln/src/kiln/pipelines.py`](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/pipelines.py) (Print pipelines), [`kiln/src/kiln/server.py`](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/server.py) (MCP server), [`kiln/src/kiln/generation/validation.py`](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/generation/validation.py) (Mesh validation), [`kiln/src/kiln/plugins/validation_pipeline_tools.py`](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/validation_pipeline_tools.py) (Validation workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Agent interface"]
  node_server["MCP server<br/>[server.py]"]
  node_cli["Kiln CLI<br/>[main.py]"]
end

subgraph group_model["Design and validation"]
  node_design["Design intelligence"]
  node_generation["Model generation"]
  node_step["STEP import<br/>[step_import.py]"]
  node_meshvalidate["Mesh validation<br/>[validation.py]"]
  node_validate_tool["Validation workflow"]
  node_validation_helpers["Validation checks"]
  node_printability["Printability analysis<br/>[printability.py]"]
end

subgraph group_print["Print preparation"]
  node_slicer["Slicing<br/>[slicer.py]"]
  node_pipeline["Print pipelines<br/>[pipelines.py]"]
  node_gcode["G-code safety<br/>[gcode.py]"]
  node_cost["Cost estimation<br/>[cost_estimator.py]"]
end

subgraph group_operations["Printer operations"]
  node_adapter["Printer adapter<br/>[base.py]"]
  node_bambu["Bambu backend<br/>[bambu.py]"]
  node_monitor["Print monitoring<br/>[print_monitor.py]"]
  node_persistence[("Local persistence<br/>[persistence.py]")]
end

subgraph group_services["Services and commerce"]
  node_marketplace["Marketplace publishing"]
  node_service_tools["Service tools<br/>[service_tools.py]"]
end

node_agent(("AI agent"))
node_printer["3D printer"]
node_marketplaces["External marketplaces"]

node_agent -->|"requests tools"| node_server
node_cli -->|"starts server"| node_server
node_server -->|"offers validation"| node_validate_tool
node_validate_tool -->|"delegates checks"| node_validation_helpers
node_validation_helpers -->|"analyzes mesh"| node_meshvalidate
node_validation_helpers -->|"checks printability"| node_printability
node_generation -->|"validates output"| node_meshvalidate
node_meshvalidate -->|"imports STEP"| node_step
node_meshvalidate -->|"assesses readiness"| node_printability
node_validate_tool -->|"converts input"| node_step
node_design -->|"uses estimates"| node_cost
node_pipeline -->|"slices model"| node_slicer
node_pipeline -->|"checks G-code"| node_gcode
node_pipeline -->|"dispatches print"| node_adapter
node_adapter -->|"controls printer"| node_printer
node_bambu -->|"implements interface"| node_adapter
node_pipeline -->|"monitors job"| node_monitor
node_pipeline -->|"records state"| node_persistence
node_server -->|"offers services"| node_service_tools
node_service_tools -->|"publishes makes"| node_marketplace
node_marketplace -.->|"publishes listings"| node_marketplaces
node_agent -->|"requests design"| node_generation

click node_server "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/server.py"
click node_cli "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/cli/main.py"
click node_design "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/design_intelligence.py"
click node_generation "https://github.com/codeofaxel/kiln/tree/main/kiln/src/kiln/generation"
click node_step "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/step_import.py"
click node_meshvalidate "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/generation/validation.py"
click node_validate_tool "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/validation_pipeline_tools.py"
click node_validation_helpers "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/_validation_pipeline_internals.py"
click node_printability "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printability.py"
click node_slicer "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/slicer.py"
click node_pipeline "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/pipelines.py"
click node_gcode "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/gcode.py"
click node_cost "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/cost_estimator.py"
click node_adapter "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printers/base.py"
click node_bambu "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printers/bambu.py"
click node_monitor "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/print_monitor.py"
click node_persistence "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/persistence.py"
click node_marketplace "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/marketplace_publish.py"
click node_service_tools "https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/service_tools.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_cli toneBlue
class node_design,node_generation,node_step,node_meshvalidate,node_validate_tool,node_validation_helpers,node_printability toneAmber
class node_slicer,node_pipeline,node_gcode,node_cost toneMint
class node_adapter,node_bambu,node_monitor,node_persistence toneRose
class node_marketplace,node_service_tools,node_agent,node_printer,node_marketplaces toneIndigo
```

## Components

### Agent interface

- [MCP server](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/server.py): `kiln/src/kiln/server.py`
- [Kiln CLI](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/cli/main.py): `kiln/src/kiln/cli/main.py`

### Design and validation

- [Design intelligence](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/design_intelligence.py): `kiln/src/kiln/design_intelligence.py`
- [Model generation](https://github.com/codeofaxel/kiln/tree/main/kiln/src/kiln/generation): `kiln/src/kiln/generation`
- [STEP import](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/step_import.py): `kiln/src/kiln/step_import.py`
- [Mesh validation](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/generation/validation.py): `kiln/src/kiln/generation/validation.py`
- [Validation workflow](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/validation_pipeline_tools.py): `kiln/src/kiln/plugins/validation_pipeline_tools.py`
- [Validation checks](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/_validation_pipeline_internals.py): `kiln/src/kiln/plugins/_validation_pipeline_internals.py`
- [Printability analysis](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printability.py): `kiln/src/kiln/printability.py`

### Print preparation

- [Slicing](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/slicer.py): `kiln/src/kiln/slicer.py`
- [Print pipelines](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/pipelines.py): `kiln/src/kiln/pipelines.py`
- [G-code safety](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/gcode.py): `kiln/src/kiln/gcode.py`
- [Cost estimation](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/cost_estimator.py): `kiln/src/kiln/cost_estimator.py`

### Printer operations

- [Printer adapter](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printers/base.py): `kiln/src/kiln/printers/base.py`
- [Bambu backend](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/printers/bambu.py): `kiln/src/kiln/printers/bambu.py`
- [Print monitoring](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/print_monitor.py): `kiln/src/kiln/print_monitor.py`
- [Local persistence](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/persistence.py): `kiln/src/kiln/persistence.py`

### Services and commerce

- [Marketplace publishing](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/marketplace_publish.py): `kiln/src/kiln/marketplace_publish.py`
- [Service tools](https://github.com/codeofaxel/kiln/blob/main/kiln/src/kiln/plugins/service_tools.py): `kiln/src/kiln/plugins/service_tools.py`

### Other components

- **AI agent**
- **3D printer**
- **External marketplaces**

## Connections

- AI agent → MCP server: requests tools (evidence: `README.md`)
- Kiln CLI → MCP server: starts server (evidence: `README.md`)
- MCP server → Validation workflow: offers validation (evidence: `kiln/src/kiln/plugins/validation_pipeline_tools.py`)
- Validation workflow → Validation checks: delegates checks (evidence: `kiln/src/kiln/plugins/validation_pipeline_tools.py`)
- Validation checks → Mesh validation: analyzes mesh (evidence: `kiln/src/kiln/plugins/_validation_pipeline_internals.py`)
- Validation checks → Printability analysis: checks printability (evidence: `kiln/src/kiln/plugins/_validation_pipeline_internals.py`)
- Model generation → Mesh validation: validates output (evidence: `kiln/src/kiln/generation/validation.py`)
- Mesh validation → STEP import: imports STEP (evidence: `kiln/src/kiln/generation/validation.py`)
- Mesh validation → Printability analysis: assesses readiness (evidence: `kiln/src/kiln/generation/validation.py`)
- Validation workflow → STEP import: converts input (evidence: `kiln/src/kiln/plugins/validation_pipeline_tools.py`)
- Design intelligence → Cost estimation: uses estimates (evidence: `kiln/src/kiln/design_intelligence.py`)
- Print pipelines → Slicing: slices model (evidence: `README.md`)
- Print pipelines → G-code safety: checks G-code (evidence: `kiln/src/kiln/pipelines.py`)
- Print pipelines → Printer adapter: dispatches print (evidence: `README.md`)
- Printer adapter → 3D printer: controls printer (evidence: `README.md`)
- Bambu backend → Printer adapter: implements interface (evidence: `kiln/src/kiln/printers/bambu.py`)
- Print pipelines → Print monitoring: monitors job (evidence: `README.md`)
- Print pipelines → Local persistence: records state (evidence: `kiln/src/kiln/pipelines.py`)
- MCP server → Service tools: offers services (evidence: `kiln/src/kiln/plugins/service_tools.py`)
- Service tools → Marketplace publishing: publishes makes (evidence: `kiln/src/kiln/plugins/service_tools.py`)
- Marketplace publishing → External marketplaces: publishes listings (evidence: `README.md`)
- AI agent → Model generation: requests design (evidence: `README.md`)
