Pandar

Bambu Studio cloud alternative.

Architecture

Client -(HTTP / WebSocket)-> pandar-hub
pandar-agent -(gRPC)-> pandar-hub
pandar-agent -(MQTT + machine file transfer)-> Bambu machines

pandar-hub is the multi-tenant Rust API server. pandar-agent runs on a user's local network and bridges hub commands to Bambu machines. The frontend is a Next.js product UI that talks only to the hub.

Documentation

• 0.1.0 changelog: release highlights, distribution channels, and known limitations.
• Release installation: archive selection, checksum verification, deployment, and plugin replacement.
• Maintainer release runbook: version checks, quality gates, tagging, and publication verification.
• Architecture: component boundaries, reference-derived machine behavior, data model, and protocol notes.
• Development and deployment notes: environment variables, local setup, auth/provisioning examples, live WebSocket notes, and verification commands.
• NixOS module options: generated services.pandar deployment options for hub, web, and agent services.
• Roadmap: completed phases and planned next phases.

Release 0.1.0

The v0.1.0 release provides native Linux amd64 and Windows amd64 CLI/plugin/BambuSource archives plus the Windows Studio hook bundle on GitHub Releases, Hub and Web images as ghcr.io/projectpandar/pandar/hub:v0.1.0 and ghcr.io/projectpandar/pandar/web:v0.1.0, and Helm chart 0.1.0 at oci://ghcr.io/projectpandar/pandar/chart/pandar.

Desktop archives will be unsigned and accompanied by SHA-256 sidecars. Read the installation guide and current compatibility evidence before production use.

Workspace

• crates/pandar-core - shared domain types.
• crates/pandar-hub - Axum API server for users and reverse agent connections.
• crates/pandar-agent - deployable local agent for Bambu machine access.
• crates/pandar-network-plugin - Bambu Studio network plugin ABI replacement scaffold that connects Studio sign-in to pandar-hub.
• crates/pandar-app - operator CLI.
• frontend - Next.js frontend.
• mobile/android - Jetpack Compose + Material 3 Android app (see docs/android.md).
• proto - gRPC contracts.
• reference - protocol and behavior references.

References

• BambuStudio: Studio product behavior, network-agent ABI caller, and print workflow reference.
• bambuddy: Bambu MQTT, discovery, file transfer, and printer-state behavior reference.
• open-bamboo-networking: Bambu Studio network plugin ABI replacement reference.

Communication with Bambu machines should be implemented from reference behavior without copying unrelated application code into the main workspace.

Quick Checks

cargo fmt
cargo clippy --workspace
cargo nextest run --manifest-path "Cargo.toml" --workspace
npm run build:web