From 6bfd5c59d9394c611a6b95a72faacbe51f0af722 Mon Sep 17 00:00:00 2001 From: "Abe Diaz (@abe238)" Date: Tue, 26 May 2026 02:12:47 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20refresh=20README=20=E2=80=94=20every=20?= =?UTF-8?q?roadmap=20item=20shipped?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replaces the 'three more in active development' paragraph with the full catalog of what's now in the box (status / control / vision / camera / timelapse / print / queue / schedule / quiet / auto-off / cal / doctor / watch / poll). Roadmap section pivots to the next horizon (local MLX-VLM, auto-calibration, MCP server). --- README.md | 55 ++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 38 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 21bb8bf..b077bdd 100644 --- a/README.md +++ b/README.md @@ -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 [--json] # one-off (machine-parseable with --json) + +# Camera capture + timelapse +bambu snap # 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 # upload via FTP and start +bambu queue add # add to persistent queue +bambu queue list | clear | start # daemon dispatches on IDLE/FINISH + +# Scheduling, quiet hours, auto-off +bambu schedule --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 --pa 0.042 --flow 0.98 --filament "PLA Basic" +bambu cal list | show | remove --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 @@ -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