AFangTeam/PrintLab

What it does

PrintLab is a local workspace and workflow for turning an idea into a printed object. It targets Mac and Windows users who have a Bambu Lab printer and work with Codex or another terminal-capable agent. You describe a need; the agent helps pick a shape, build the model, compare slicings, and keep versions, materials, print records and physical feedback in one workspace.

The workspace holds a project gallery, real 3D model previews, design versions, device/material/captured print history supplied by Bambuddy, inspiration favorites, accessory lists, stock and purchase records, and print packages with time, usage and confirmations bound to a task.

Quick start

Prerequisites: Python 3.11+, Node.js 22+, git, and a Bambu Lab printer for device features (the generic workspace runs without one).

git clone https://github.com/AFangTeam/PrintLab.git
cd PrintLab
bash scripts/setup.sh
bash scripts/start.sh

Then open http://127.0.0.1:8018. Setup creates an empty workspace and local config; rerunning keeps existing config. If the system Python is too old, pass PRINTLAB_PYTHON=/your/python3 bash scripts/setup.sh. The install guide covers details.

Alternatively download PrintLab.zip from the latest release, or run the equivalent curl/unzip sequence. Windows users install Python 3.11+ and Node.js 22+, then run in PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start.ps1

An agent-driven path is also documented: send the repository link and the provided installation prompt to Codex or another agent with local terminal and file access, which follows the README, AGENTS.md and the agent start guide. First-time device details are collected through the configuration interview. The Getting Started guide shows the chat and web interaction examples.

Constraints

• macOS 14+ is supported, Apple Silicon recommended; Windows uses native PowerShell scripts and a browser workspace.
• Device status and print history depend on Bambuddy installed separately; third-party tools, model weights, Bambu software and plugins must be obtained from their own official sources.
• The bundled automatic send profile targets X2D, Chinese Bambu Studio 02.08.02.61, 0.4 mm, single-material AMS, left main nozzle, and textured PEI single plate. Other models, versions and multi-material routes need case-by-case checking.
• Bambu Cloud history and MakerWorld account favorites import are out of scope for this release; users relying on Handy, cloud printing or account favorites should flag those needs at install time.
• Original source and docs use PolyForm Noncommercial 1.0.0; noncommercial use, modification and redistribution are allowed with the license and NOTICE.txt attribution. Commercial use requires separate authorization from AFangTeam.
• Tests use temporary workspaces and synthetic devices; live read-only checks require PRINTLAB_LIVE_TEST=1.

HotRepo's take

PrintLab appeared on the Python new-project list on 2026-11-12, recording 109 stars and 12 forks with 5 stars added in about 90 minutes of the tracked window. That is a very short observation, so the numbers only establish that the repository drew early attention, not a durable trend. The project's interest lies in combining an agent workflow with a concrete hardware process; the narrow validated send profile (a single printer/software combination) means readers with other setups should treat the workspace as usable but the automated printing path as needing their own verification.

Project source and documentation