Integrations Overview

PrintStudio’s core platform runs independently with just Postgres and Redis. The integrations layer adds optional ecosystem services for workflow automation, print farm management, AI failure detection, and mobile operations.

All integrations are configured via the Setup Wizard or by setting environment variables in .env.

Integration Map

Integration	Category	Purpose
n8n	Automation	Workflow automation — order emails, alerts, cross-service orchestration
OpenClaw	AI / Mobile	Natural-language ops via WhatsApp, Telegram, Discord
OrcaSlicer	Production	G-code generation from STL/3MF files
Moonraker/Klipper	Hardware	Control Klipper-based printers (Voron, custom CoreXY)
Bambu Lab	Hardware	Control Bambu X1C, P1, A1 via MQTT LAN API
InvenTree	Inventory	Parts and material inventory management
Stripe	Commerce	Payments, checkout, refunds, billing

Architecture

All integrations share a common IntegrationHub entry point in packages/integrations:

import { IntegrationHub } from "@printstudio/integrations";

const hub = new IntegrationHub({
  n8n: { url: process.env.N8N_URL, apiKey: process.env.N8N_API_KEY },
  moonraker: { url: process.env.MOONRAKER_URL },
  stripe: { secretKey: process.env.STRIPE_SECRET_KEY },
  // ... other integrations
});

// Health check all configured integrations
const health = await hub.healthCheckAll();

The IntegrationHub only initialises adapters for services that have the required environment variables set. Missing configuration is silently skipped — the hub operates in graceful degradation mode.

Starting the Full Ecosystem

# Start all ecosystem services via Docker
./scripts/start-ecosystem.sh -d

# Check which services are running
docker compose -f docker-compose.yml -f docker-compose.ecosystem.yml ps

Environment Variables Reference

# n8n
N8N_URL=http://localhost:5678
N8N_API_KEY=replace-me
N8N_USER=admin
N8N_PASSWORD=printstudio

# Moonraker
MOONRAKER_URL=http://192.168.1.100:7125
MOONRAKER_API_KEY=           # optional

# Bambu
BAMBU_PRINTER_IP=192.168.1.50
BAMBU_PRINTER_SN=01P00A123456789
BAMBU_ACCESS_CODE=12345678

# InvenTree
INVENTREE_URL=http://localhost:8000
INVENTREE_TOKEN=your-api-token

# OpenClaw
OPENCLAW_URL=http://localhost:18789
OPENCLAW_TOKEN=replace-me

# Stripe (see stripe page for full list)
STRIPE_SECRET_KEY=sk_live_...

System Requirements

Configuration	RAM	Disk
Core only (Postgres + Redis)	2 GB	2 GB
+ n8n	2.5 GB	2.5 GB
+ FDM Monster + MongoDB	3 GB	3 GB
Full ecosystem (all services)	8 GB	10 GB