How heyixuan2/bambu-studio-ai works
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: analyze.py Model analysis · pipeline.py Generation engine · slice.py Slice CLI · monitor.py Monitor CLI
Components 24
Model creation
- Design search
scripts/bambu_studio_ai/search/core.py - Parametric CAD
scripts/parametric.py - AI generation CLI
scripts/generate.py - Generation engine
scripts/bambu_studio_ai/generation/pipeline.py - 3D providers
scripts/bambu_studio_ai/generation/providers/base.py
Model preparation
- Mesh checks
scripts/bambu_studio_ai/mesh/checks.py - Model analysis
scripts/analyze.py - Preview CLI
scripts/preview.py - Render pipeline
scripts/bambu_studio_ai/render/pipeline.py - Colorization CLI
scripts/colorize/__main__.py - Color pipeline
scripts/bambu_studio_ai/color/pipeline.py - Filament matching
scripts/bambu_studio_ai/filaments.py
Print workflow
- Slice CLI
scripts/slice.py - Slice settings
scripts/bambu_studio_ai/slicing/resolve.py - Bambu Studio
Printer services
- Monitor CLI
scripts/monitor.py - Printer client
scripts/bambu_studio_ai/printer/client.py - Printer status
scripts/bambu_studio_ai/printer/report.py
Shared foundations
- Printer/material data
scripts/bambu_studio_ai/hardware.py - Shared config
scripts/common.py - Task ledger
scripts/bambu_studio_ai/generation/ledger.py
Other components
- User / agent
- Model providers
- Bambu printer
Connections 26
- 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
scripts/generate.py - Generation engine → 3D providers: dispatches tasks
scripts/bambu_studio_ai/generation/pipeline.py - Generation engine → Task ledger: records follow-ups
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
scripts/preview.py - User / agent → Colorization CLI: colorizes model
- Colorization CLI → Color pipeline: processes texture
scripts/colorize/__main__.py - Color pipeline → Filament matching: matches filaments
- User / agent → Slice CLI: requests slicing
- Slice CLI → Slice settings: resolves settings
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
scripts/parametric.py - Shared config → Printer/material data: loads hardware data
scripts/common.py - Model analysis → Printer/material data: checks compatibility