Self-hosted print archive and management system for Bambu Lab 3D printers

Features • Screenshots • Quick Start • Documentation • Contributing

Testers Needed! I only have X1C and H2D devices. Help make Bambuddy work with all Bambu Lab printers by reporting your experience!

• Own your data — All print history stored locally, no cloud dependency
• Works offline — Uses LAN Mode for direct printer communication
• Full automation — Schedule prints, auto power-off, get notified when done
• Multi-printer support — Manage your entire print farm from one interface

Plus: Dark/light theme • Mobile responsive • Keyboard shortcuts • Multi-language (EN/DE) • Auto updates • Database backup/restore • System info dashboard

• Python 3.10+ (3.11/3.12 recommended)
• Bambu Lab printer with LAN Mode enabled
• Same local network as printer

git clone https://github.com/maziggy/bambuddy.git
cd bambuddy
docker compose up -d

Open http://localhost:8000 in your browser.

cd bambuddy && git pull && docker compose up -d --build

# View logs
docker compose logs -f

# Stop/Start
docker compose down
docker compose up -d

# Shell access
docker compose exec bambuddy /bin/bash

ports:
  - "3000:8000"  # Access on port 3000

server {
    listen 443 ssl http2;
    server_name bambuddy.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 86400;
    }
}

services:
  bambuddy:
    build: .
    network_mode: host

# Clone and setup
git clone https://github.com/maziggy/bambuddy.git
cd bambuddy
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Run
uvicorn backend.app.main:app --host 0.0.0.0 --port 8000

Open http://localhost:8000 and add your printer!

Need detailed instructions? See the Installation Guide

1. On printer: Settings → Network → LAN Mode
2. Enable LAN Mode and note the Access Code
3. Find IP address in network settings
4. Find Serial Number in device info

Full documentation available at wiki.bambuddy.cool:

• Installation — All installation methods
• Getting Started — First printer setup
• Features — Detailed feature guides
• Troubleshooting — Common issues & solutions
• API Reference — REST API documentation

Contributions welcome! Here's how to help:

1. Test — Report issues with your printer model
2. Translate — Add new languages
3. Code — Submit PRs for bugs or features
4. Document — Improve wiki and guides

# Development setup
git clone https://github.com/maziggy/bambuddy.git
cd bambuddy

# Backend
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
DEBUG=true uvicorn backend.app.main:app --reload

# Frontend (separate terminal)
cd frontend && npm install && npm run dev

See CONTRIBUTING.md for guidelines.

MIT License — see LICENSE for details.

• Bambu Lab for amazing printers
• The reverse engineering community for protocol documentation
• All testers and contributors

Made with ❤️ for the 3D printing community

Report Bug • Request Feature • Documentation