# heyixuan2/bambu-studio-ai architecture

> Architecture diagram of the GitHub repository heyixuan2/bambu-studio-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/heyixuan2/bambu-studio-ai
- Repository: https://github.com/heyixuan2/bambu-studio-ai

## Overview

Bambu Studio AI is an agent-facing 3D-printing skill: a user request is routed to search, parametric CAD, or AI generation, then models are checked and previewed before the user slices and starts printing in Bambu Studio. Separate capabilities cover textured-model colorization, printer-status monitoring, and printer/material knowledge. The README documents the main user workflow; source-index references and excerpts support selected internal calls, but many subsystem implementations were not sampled, so uncertain links are omitted.

Main entry points: [`scripts/analyze.py`](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/analyze.py) (Model analysis), [`scripts/bambu_studio_ai/generation/pipeline.py`](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/pipeline.py) (Generation engine), [`scripts/slice.py`](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/slice.py) (Slice CLI), [`scripts/monitor.py`](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/monitor.py) (Monitor CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Model creation"]
  node_search["Design search<br/>[core.py]"]
  node_parametric["Parametric CAD<br/>[parametric.py]"]
  node_generation_cli["AI generation CLI<br/>[generate.py]"]
  node_generation_engine["Generation engine<br/>[pipeline.py]"]
  node_provider["3D providers<br/>[base.py]"]
end

subgraph group_prepare["Model preparation"]
  node_mesh_checks["Mesh checks<br/>[checks.py]"]
  node_analysis["Model analysis<br/>[analyze.py]"]
  node_preview_cli["Preview CLI<br/>[preview.py]"]
  node_render["Render pipeline<br/>[pipeline.py]"]
  node_colorize_cli["Colorization CLI<br/>[__main__.py]"]
  node_color_pipeline["Color pipeline<br/>[pipeline.py]"]
  node_filaments["Filament matching<br/>[filaments.py]"]
end

subgraph group_print["Print workflow"]
  node_slice_cli["Slice CLI<br/>[slice.py]"]
  node_slice_profiles["Slice settings<br/>[resolve.py]"]
  node_bambu_studio["Bambu Studio"]
end

subgraph group_printer["Printer services"]
  node_monitor_cli["Monitor CLI<br/>[monitor.py]"]
  node_printer_client["Printer client<br/>[client.py]"]
  node_printer_status["Printer status<br/>[report.py]"]
end

subgraph group_shared["Shared foundations"]
  node_hardware[("Printer/material data<br/>[hardware.py]")]
  node_shared_config["Shared config<br/>[common.py]"]
  node_generation_ledger[("Task ledger<br/>[ledger.py]")]
end

node_user(("User / agent"))
node_external_models["Model providers"]
node_printer_device["Bambu printer"]

node_user -->|"finds designs"| node_search
node_user -->|"requests CAD"| node_parametric
node_user -->|"requests generation"| node_generation_cli
node_search -.->|"returns models"| node_analysis
node_generation_cli -->|"runs tasks"| node_generation_engine
node_generation_engine -->|"dispatches tasks"| node_provider
node_generation_engine -->|"records follow-ups"| node_generation_ledger
node_provider -.->|"requests models"| node_external_models
node_analysis -.->|"checks geometry"| node_mesh_checks
node_user -->|"checks model"| node_analysis
node_user -->|"requests preview"| node_preview_cli
node_preview_cli -->|"renders views"| node_render
node_user -->|"colorizes model"| node_colorize_cli
node_colorize_cli -->|"processes texture"| node_color_pipeline
node_color_pipeline -.->|"matches filaments"| node_filaments
node_user -->|"requests slicing"| node_slice_cli
node_slice_cli -->|"resolves settings"| node_slice_profiles
node_slice_cli -.->|"opens for slicing"| node_bambu_studio
node_user -->|"reviews and prints"| node_bambu_studio
node_user -->|"requests monitoring"| node_monitor_cli
node_monitor_cli -.->|"reads status"| node_printer_client
node_printer_client -.->|"queries network"| node_printer_device
node_monitor_cli -->|"reports progress"| node_printer_status
node_parametric -->|"uses utilities"| node_shared_config
node_shared_config -->|"loads hardware data"| node_hardware
node_analysis -.->|"checks compatibility"| node_hardware

click node_search "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/search/core.py"
click node_parametric "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/parametric.py"
click node_generation_cli "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/generate.py"
click node_generation_engine "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/pipeline.py"
click node_provider "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/providers/base.py"
click node_mesh_checks "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/mesh/checks.py"
click node_analysis "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/analyze.py"
click node_preview_cli "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/preview.py"
click node_render "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/render/pipeline.py"
click node_colorize_cli "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/colorize/__main__.py"
click node_color_pipeline "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/color/pipeline.py"
click node_filaments "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/filaments.py"
click node_slice_cli "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/slice.py"
click node_slice_profiles "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/slicing/resolve.py"
click node_monitor_cli "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/monitor.py"
click node_printer_client "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/printer/client.py"
click node_printer_status "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/printer/report.py"
click node_hardware "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/hardware.py"
click node_shared_config "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/common.py"
click node_generation_ledger "https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/ledger.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_search,node_parametric,node_generation_cli,node_generation_engine,node_provider,node_user toneBlue
class node_mesh_checks,node_analysis,node_preview_cli,node_render,node_colorize_cli,node_color_pipeline,node_filaments toneAmber
class node_slice_cli,node_slice_profiles,node_bambu_studio toneMint
class node_monitor_cli,node_printer_client,node_printer_status toneRose
class node_hardware,node_shared_config,node_generation_ledger,node_external_models,node_printer_device toneIndigo
```

## Components

### Model creation

- [Design search](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/search/core.py): `scripts/bambu_studio_ai/search/core.py`
- [Parametric CAD](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/parametric.py): `scripts/parametric.py`
- [AI generation CLI](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/generate.py): `scripts/generate.py`
- [Generation engine](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/pipeline.py): `scripts/bambu_studio_ai/generation/pipeline.py`
- [3D providers](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/providers/base.py): `scripts/bambu_studio_ai/generation/providers/base.py`

### Model preparation

- [Mesh checks](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/mesh/checks.py): `scripts/bambu_studio_ai/mesh/checks.py`
- [Model analysis](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/analyze.py): `scripts/analyze.py`
- [Preview CLI](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/preview.py): `scripts/preview.py`
- [Render pipeline](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/render/pipeline.py): `scripts/bambu_studio_ai/render/pipeline.py`
- [Colorization CLI](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/colorize/__main__.py): `scripts/colorize/__main__.py`
- [Color pipeline](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/color/pipeline.py): `scripts/bambu_studio_ai/color/pipeline.py`
- [Filament matching](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/filaments.py): `scripts/bambu_studio_ai/filaments.py`

### Print workflow

- [Slice CLI](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/slice.py): `scripts/slice.py`
- [Slice settings](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/slicing/resolve.py): `scripts/bambu_studio_ai/slicing/resolve.py`
- **Bambu Studio**

### Printer services

- [Monitor CLI](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/monitor.py): `scripts/monitor.py`
- [Printer client](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/printer/client.py): `scripts/bambu_studio_ai/printer/client.py`
- [Printer status](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/printer/report.py): `scripts/bambu_studio_ai/printer/report.py`

### Shared foundations

- [Printer/material data](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/hardware.py): `scripts/bambu_studio_ai/hardware.py`
- [Shared config](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/common.py): `scripts/common.py`
- [Task ledger](https://github.com/heyixuan2/bambu-studio-ai/blob/main/scripts/bambu_studio_ai/generation/ledger.py): `scripts/bambu_studio_ai/generation/ledger.py`

### Other components

- **User / agent**
- **Model providers**
- **Bambu printer**

## Connections

- User / agent → Design search: finds designs
- User / agent → Parametric CAD: requests CAD
- User / agent → AI generation CLI: requests generation
- Design search → Model analysis: returns models
- AI generation CLI → Generation engine: runs tasks (evidence: `scripts/generate.py`)
- Generation engine → 3D providers: dispatches tasks (evidence: `scripts/bambu_studio_ai/generation/pipeline.py`)
- Generation engine → Task ledger: records follow-ups (evidence: `scripts/bambu_studio_ai/generation/pipeline.py`)
- 3D providers → Model providers: requests models
- Model analysis → Mesh checks: checks geometry
- User / agent → Model analysis: checks model
- User / agent → Preview CLI: requests preview
- Preview CLI → Render pipeline: renders views (evidence: `scripts/preview.py`)
- User / agent → Colorization CLI: colorizes model
- Colorization CLI → Color pipeline: processes texture (evidence: `scripts/colorize/__main__.py`)
- Color pipeline → Filament matching: matches filaments
- User / agent → Slice CLI: requests slicing
- Slice CLI → Slice settings: resolves settings (evidence: `scripts/slice.py`)
- Slice CLI → Bambu Studio: opens for slicing
- User / agent → Bambu Studio: reviews and prints
- User / agent → Monitor CLI: requests monitoring
- Monitor CLI → Printer client: reads status
- Printer client → Bambu printer: queries network
- Monitor CLI → Printer status: reports progress
- Parametric CAD → Shared config: uses utilities (evidence: `scripts/parametric.py`)
- Shared config → Printer/material data: loads hardware data (evidence: `scripts/common.py`)
- Model analysis → Printer/material data: checks compatibility
