Skip to content

Releases: heyixuan2/bambu-studio-ai

v1.0.1 — Test Stability Fixes

10 Mar 17:36

Choose a tag to compare

  • Skip parametric tests when manifold3d is unavailable
  • Fix oversized model scoring cap in analyze.py
  • Test suite now passes cleanly: 53 passed, 1 skipped

v1.0.0 — First Major Release 🎉

10 Mar 17:27

Choose a tag to compare

🖨️ Bambu Studio AI v1.0.0

The most complete open-source AI agent skill for Bambu Lab 3D printers.

What's New in v1.0.0

🔧 Parametric Modeling (parametric.py)

  • manifold3d CSG: box, cylinder, sphere, extrude, bracket, plate-with-holes, enclosure (+lid)
  • JSON spec files for complex assemblies (union/subtract/intersect/hull)
  • FDM tolerance tables (M2-M8 screw holes, heat-set inserts, clearance fits)
  • Guaranteed watertight output — zero non-manifold edges

📷 Image-to-3D Pipeline

  • Auto image validation (format, size, resolution)
  • Background removal via rembg
  • URL image download
  • Post-generation texture detection (auto-route to colorize)

🎨 Multi-Color AMS Pipeline

  • HSV family classification (shadow-immune)
  • Dual method: hybrid (preserves rare colors) + k-means (sub-color detail)
  • Bambu filament CIELAB matching with ΔE scores
  • Boundary smoothing, island cleanup, vertex snap

📊 Full Pipeline

  • Model search (MakerWorld, Printables, Thingiverse, Thangs)
  • 5 AI providers (Rodin, Meshy, Tripo3D, Printpal, 3D AI Studio)
  • 11-point printability analysis + auto-repair
  • Blender Cycles preview (turntable GIF)
  • CLI slicing (OrcaSlicer)
  • Print monitoring + notifications
  • All 9 Bambu Lab printers

🧪 Test Suite: 57 tests across 8 test files
📖 README: Complete rewrite with narrative structure

Supported Printers

A1 Mini · A1 · P1S · P2S · X1C · X1E · H2C · H2S · H2D

v0.23.0 — Colorize Module Refactor + Test Suite

08 Mar 16:16

Choose a tag to compare

What's New

🎨 Colorize Module Refactor

  • colorize.pycolorize/ package (7 submodules)
  • Dual method: --method hybrid (default, hue-preserving) + --method kmeans (sub-color detail)
  • All CLI args (--no-merge, --island-size, --smooth) now properly passed through

🧪 Test Suite

  • 5 test files: color_science, selection, scoring, snap_colors, conftest
  • Run: pytest tests/

🔧 Infrastructure

  • common.py: shared config, cross-platform paths (macOS/Linux/Windows), threading timeout
  • _BaseBackend: unified download with retry + backoff
  • pyproject.toml for project metadata
  • GPU multi-backend preview (METAL/CUDA/OPTIX/HIP)

🚀 Generation

  • Auto-retry with prompt refinement on failure
  • Hyper3D Rodin provider support

🐛 40+ Bug Fixes (v0.20.0 → v0.23.0)

  • auto_scale skips 3MF, download retry, HSV threshold alignment
  • hybrid max_colors cap (AMS 8-slot safe), URL-encode RTSP
  • Doctor checks scikit-learn, preview rendering mandatory in workflow

v0.20.0 — CLI Slicing & Smart Monitor

03 Mar 22:33

Choose a tag to compare

🆕 New Features

CLI Slicer (slice.py)

  • Full OrcaSlicer CLI integration with auto profile merging
  • Auto-resolves Bambu Studio profile inheritance chains (machine → process → filament)
  • Auto-detects printer model, nozzle size, AMS filaments from live printer
  • Quality presets: draft (0.24mm) / standard (0.20mm) / fine (0.12mm) / extra (0.08mm)
  • --orient and --arrange flags for auto-orientation and plate arrangement
  • 3MF post-processing for Bambu Studio 2.5.0 compatibility (no more warning dialogs)
  • All 9 Bambu Lab printer models supported

Smart Print Monitor (monitor.py rewrite)

  • Anomaly detection: progress stall (>10min), temperature spikes, print failures
  • Notification policy: immediate alerts on anomalies, 30-min progress summaries
  • --auto-pause flag for critical anomaly auto-response
  • Persistent state tracking across monitor cycles

New Commands (bambu.py)

  • info — printer hardware info (model, nozzle, AMS filaments), works offline with config fallback
  • notify — send notifications to user's channel
  • status --json — machine-readable printer status for automation

🐛 Bug Fixes (8 audit rounds, 20+ fixes)

  • generate.py: --format 3mf now correctly produces .3mf output
  • colorize.py: auto-adds .obj extension to output
  • bambu.py: fixed dispatch for info/notify/status --json commands
  • slice.py: relative output paths now work correctly
  • doctor.py: now checks OrcaSlicer installation
  • monitor.py: all notifications in English (consistency)
  • All scripts: path hints use scripts/ prefix
  • 3MF values patched for Bambu Studio compatibility

📊 Stats

  • 10 scripts, 5,818 lines of Python
  • 50-model stress test: 90% success rate (45/50)