Skip to content

HughKantsime/runsodin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

701 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

O.D.I.N.

Self-hosted 3D print farm management

Version License CI Docker Website Stars

Website · Install · Features · Pricing


Self-hosted print farm management that combines multi-protocol printer support, AI failure detection, and business operations in a single container. No cloud dependency. No per-printer fees. Your data stays on your network.

Key Features

  • Multi-Protocol Fleet — Klipper/Moonraker, PrusaLink, Bambu MQTT (X1C, P1S, A1, H2D), and Elegoo SDCP from one dashboard
  • Vigil AI Failure Detection — ONNX-based spaghetti/detachment/first-layer detection with auto-pause
  • Smart Job Scheduling — Color-match scoring, time-window matching, drag-and-drop queue
  • Mid-Print Controls — Skip objects, adjust speed (25%–200%), and clear HMS errors during active prints
  • Print Archive — Auto-captures every completed print with metadata, thumbnails, and searchable history
  • OBS Streaming Overlay — Auth-free /overlay/:printerId page for live streaming with camera, progress, and temps
  • Order-to-Ship Workflow — Products, BOM, orders, invoicing, cost tracking, and shipping in one system
  • WebRTC Camera Streaming — Live feeds via go2rtc with control room mode, PiP, and timelapse capture
  • Spool Inventory — Filament tracking with QR labels, AMS integration, PA profiles, low-stock alerts, bidirectional Spoolman sync (pull inventory + push consumption), and CSV export
  • Notifications — Discord, Slack, Telegram, ntfy, WhatsApp, Pushover, email, and browser push
  • Enterprise Security — RBAC (admin/operator/viewer), TOTP MFA, Microsoft Entra ID SSO, IP allowlisting, audit logs
  • Native Companion Apps — iOS, iPadOS, and macOS apps with fleet view, widgets, and Live Activities (odin-native)
  • Single Container Deploy — One docker compose up, ~256 MB RAM, all 9 services included

Quick Install

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/HughKantsime/runsodin/main/install/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/HughKantsime/runsodin/main/install/install.ps1 | iex

See Windows Installation Guide for detailed instructions.

Or with Docker Compose directly:

mkdir odin && cd odin
curl -O https://raw.githubusercontent.com/HughKantsime/runsodin/main/install/docker-compose.yml
docker compose up -d

Open http://your-server-ip:8000 and follow the setup wizard.

Screenshots

Fleet Overview

Printers page showing Klipper, Bambu, and Elegoo printers with spool inventory, temperatures, and status

Camera Streaming

Camera grid with live WebRTC feeds, Control Room and TV Mode buttons

Comparison

O.D.I.N. SimplyPrint 3DPrinterOS Obico
Annual cost (20 printers) $150 flat $960-1,440 $2,280+ $960-1,440
Pricing model Flat license Per-printer SaaS Per-printer SaaS Per-printer SaaS
Self-hosted Yes No No Partial
Printer protocols 4 (Bambu, Klipper, Prusa, Elegoo) 2 Many (via agent) OctoPrint only
AI failure detection Included Add-on ($) No Core product
Business ops (orders/BOM/invoicing) Yes No No No
Air-gap / offline Yes No No No
MFA + SSO TOTP + Microsoft Entra ID Yes Yes No

Stack

  • Backend — Python 3.11, FastAPI, SQLAlchemy, SQLite (WAL mode)
  • Frontend — React 18, Vite, TailwindCSS, React Query
  • Streaming — go2rtc (WebRTC, RTSP)
  • AI — ONNX Runtime (Vigil AI failure detection)
  • Deploy — Docker, supervisord (9 managed processes)

Agents (v1.8.9+)

O.D.I.N. speaks Model Context Protocol natively. Drive the farm from Claude Desktop, Claude Code, OpenClaw, or any MCP-compatible client — with idempotent retries, dry-run previews, structured error codes, and a local-LLM deployment path designed for ITAR/CMMC environments.

Documentation

  • Full Documentation — Installation, configuration, features, API reference, troubleshooting
  • Install Guide — Setup, configuration, and updating
  • Features — Full feature catalog
  • Pricing — Community, Pro, Education, Enterprise tiers
  • API Docs — Swagger UI at /api/docs on your running instance
  • CHANGELOG — Version history
  • SECURITY — Security policy and vulnerability reporting

Community

Contributing

Contributions are welcome — bug reports, feature requests, docs fixes, and PRs. See CONTRIBUTING.md for the full guide.

  • File a bug — open a GitHub issue with steps to reproduce
  • Request a feature — describe the problem first, then your proposed solution
  • Submit a PR — fork, branch off main, run tests, and open the PR
  • Help others — answer questions on Discord or in GitHub issues
  • Star the repo — it helps new operators find the project

For security vulnerabilities, please follow the disclosure process in SECURITY.md.

License

O.D.I.N. is licensed under the Business Source License 1.1. Source-available, not open source.

  • Free for personal and non-commercial use (Community tier: 5 printers, 1 user)
  • Commercial use requires a paid license (Pro, Education, or Enterprise)
  • On 2029-02-07 the license converts to Apache 2.0

License keys are verified locally with Ed25519 signatures. No phone home, no cloud dependency.


About

Self-hosted 3D print farm management — MES meets SCADA. Bambu Lab, Klipper, Prusa, Elegoo. No cloud required.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors