Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 38 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,24 +65,41 @@ Required Python: **3.10+** (3.14 recommended). macOS or Linux.
```sh
# State & control
bambu status # one-shot: state, temps, layer, ETA
bambu pause # pause the running print
bambu resume
bambu cancel --yes # destructive — requires --yes
bambu pause | resume | cancel --yes # destructive commands need --yes
bambu home # home the print head
bambu light on | off # chamber LED
bambu doctor # firmware + library + known-bug report

# AI failure detection (issue #20)
bambu vision watch # long-running daemon with adaptive sampling + auto-pause
bambu vision classify path/to/frame.jpg # one-off verdict
bambu vision classify f.jpg --json # machine-parseable verdict for agents
# AI failure detection
bambu vision watch # long-running daemon, adaptive sampling, auto-pause
bambu vision classify <frame.jpg> [--json] # one-off (machine-parseable with --json)

# Camera capture + timelapse
bambu snap <out.jpg> # one frame from the chamber camera
bambu stream --out-dir ./tl --interval 30 # periodic capture
bambu timelapse stitch ./tl --out out.mp4 # ffmpeg-stitch into MP4

# Upload + start + queue
bambu print <file.3mf> # upload via FTP and start
bambu queue add <file.3mf> # add to persistent queue
bambu queue list | clear | start # daemon dispatches on IDLE/FINISH

# Scheduling, quiet hours, auto-off
bambu schedule <name> --at 07:00 # start an existing print at HH:MM
bambu quiet --from 23:00 --to 09:00 # cap aux fan during the window
bambu auto-off --webhook URL [--exec CMD] # fire hooks on FINISH/FAILED

# Calibration tracking
bambu cal log <spool> --pa 0.042 --flow 0.98 --filament "PLA Basic"
bambu cal list | show <spool> | remove <spool> --yes

# Notifications + live tail
bambu-watch # FINISH / FAILED / PAUSE / HMS → ntfy.sh → phone
bambu-watch [--heartbeat] [--notify-bed-temp C] [--notify-nozzle-temp C]
bambu-poll # live MQTT state tail
```

Three more roadmap items are in active development — print queue, scheduled
prints, quiet hours, etc. See [GitHub Issues](https://github.com/abe238/bambu-ai/issues).
Every subcommand has `--help`. All long-running daemons are Ctrl-C-able.
See [`docs/`](./docs/) for per-feature deep dives.

## What this looks like with an agent

Expand Down Expand Up @@ -195,13 +212,17 @@ task, read [`AGENTS.md`](./AGENTS.md) first. It explains:

## Roadmap

In active development. Tracked in [GitHub Issues](https://github.com/abe238/bambu-ai/issues),
all distilled from a recent 30-day audit of r/BambuLab, the Bambu forum,
ha-bambulab, and HN:

- **Tier 1** (high-frequency × high-tractability): notify-on-temp (#9), scheduled prints (#10), quiet hours (#11), auto-off after print (#12)
- **Tier 2** (frequent, multi-step): upload+start (#3), camera capture (#4), calibration tracking (#7), print queue (#13), heartbeat alarm (#14)
- **Tier 3** (specific bug-class): timelapse stitching (#15), `bambu doctor` firmware-compat report (#16)
The original Tier 1–3 roadmap (distilled from a 30-day audit of r/BambuLab,
the Bambu forum, ha-bambulab, and HN) is fully shipped — see [closed
issues](https://github.com/abe238/bambu-ai/issues?q=is%3Aissue+is%3Aclosed).
Follow-ups land as new issues; the high-leverage next steps are:

- Local-first vision provider (MLX-VLM) — slot into the existing
`VisionProvider` interface so the same `bambu vision watch` runs offline.
- Auto-running calibration (parsing K from the printer's calibration print
output, then `bambu cal log`-ing it without manual entry).
- MCP server wrapping these commands so Claude Desktop / ChatGPT can drive
the printer alongside Claude Code.

## Security

Expand Down
Loading