Skip to content

HughKantsime/runsodin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

717 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

Dark-mode O.D.I.N. printer utilization report with live fleet metrics, job counts, success rate, charts, and per-printer breakdown

Camera Streaming

Dark-mode O.D.I.N. camera page showing a live A1 camera feed with Control Room and TV Mode controls

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