Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

Blb3D/filaops

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FilaOps - 3D Print Farm ERP

The ERP that understands additive manufacturingβ€”built by a print farm, for print farms.

License: BSL 1.1 Python 3.11+ FastAPI Docker Ready Discord


Why FilaOps?

Most ERP systems are built for traditional manufacturing. They don't understand filament spools, print times, multi-material jobs, or why you need to track which roll went into which print.

FilaOps was built by someone who runs a print farm and got tired of spreadsheets and generic software that didn't fit.

What makes it different:

  • 3D printing native - BOMs that understand filament, print times, and material costs
  • Actually usable - Docker setup, dark theme UI, no enterprise sales calls required
  • Self-hosted & open - Your data stays yours. No cloud dependency, no vendor lock-in
  • Production-grade - Serial/lot traceability ready for medical device and aerospace compliance

Quick Start

git clone https://github.com/Blb3D/filaops.git
cd filaops
docker-compose up -d

Open http://localhost:5173 β€” the Setup Wizard will guide you through creating your admin account.

That's it. Database, API, and UI are all pre-configured.

πŸ“– Full Installation Guide for manual setup or troubleshooting.

Note for developers: There's also a docker-compose.dev.yml file for local development. End users should use docker-compose.yml (the default).


What's Included

Core ERP (Free, Self-Hosted)

Module What It Does
Products & Items Unified catalog for finished goods, components, filament, hardware
Bill of Materials Multi-level BOMs with material costs and unit tracking
Inventory Stock levels, FIFO tracking, low stock alerts
Sales Orders Order management with status tracking
Production Orders Manufacturing workflow from order to ship
Scrap & Remake Track print failures with configurable reasons, partial scrap, auto-remake orders
MRP Material requirements planning with shortage detection
Traceability Serial numbers, lot tracking, forward/backward recall queries
Multi-User Team access with user accounts
REST API Full API for integrations and automation

Admin Dashboard

  • Dark theme (your eyes will thank you at 2am)
  • Real-time KPIs: overdue orders, low stock, revenue
  • Order Command Center with MRP explosion

Feature Comparison

The core ERP is fully functional and free to self-host. Pro and Enterprise tiers add integrations and advanced features for larger operations.

Community Pro Enterprise
Core ERP βœ… βœ… βœ…
Products, BOMs, Inventory βœ… βœ… βœ…
Sales & Production Orders βœ… βœ… βœ…
MRP & Shortage Detection βœ… βœ… βœ…
Serial/Lot Traceability βœ… βœ… βœ…
Multi-User βœ… βœ… βœ…
REST API βœ… βœ… βœ…
Docker Deployment βœ… βœ… βœ…
Integrations
Customer Quote Portal β€” βœ… βœ…
Multi-Material/AMS Quoting β€” βœ… βœ…
Squarespace Sync β€” βœ… βœ…
QuickBooks Integration β€” βœ… βœ…
Advanced
Advanced Role Permissions β€” βœ… βœ…
User Activity Audit Logs β€” βœ… βœ…
ML Print Time Estimation β€” β€” βœ…
Printer Fleet Management β€” β€” βœ…
SSO / LDAP β€” βœ… βœ…
Priority Support β€” β€” βœ…

Pro & Enterprise launching 2026 β€” Join the waitlist


βš™οΈ Build Configuration (Community Edition)

The community version uses development mode builds for the frontend to maximize debuggability and contributor experience:

  • βœ… Unminified code - Easy to debug and understand
  • βœ… Source maps included - Full stack traces with real line numbers
  • βœ… Readable variable names - Contributing PRs is easier
  • ⚠️ Larger bundle size (~2MB vs ~1MB minified)

This is intentional for self-hosted deployments where source code is already visible and performance impact is negligible on local networks.

πŸ“ For SaaS/Production hosting: Production builds require refactoring ~30 components to fix React hook timing issues. See frontend/PRODUCTION_BUILD_BLOCKED.md for details. This only affects public-facing deployments; self-hosted users are unaffected.


Documentation

INSTALL.md Installation guide (Docker & manual)
HOW_IT_WORKS.md System overview and workflows
docs/EMAIL_CONFIGURATION.md Email/SMTP setup guide
KNOWN_ISSUES.md Known issues and workarounds
TROUBLESHOOTING.md Common issues and fixes
FAQ.md Frequently asked questions
CONTRIBUTING.md For contributors
docs/ Full documentation (architecture, API, planning)

For Developers

Local Development Setup

Prerequisites: Python 3.11+, Node.js 18+, SQL Server Express, ODBC Driver 17

# Backend
cd backend
pip install -r requirements.txt
cp .env.example .env
python -m uvicorn app.main:app --reload --port 8000

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

Project Structure

filaops/
β”œβ”€β”€ backend/           # FastAPI API
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ api/       # REST endpoints
β”‚   β”‚   β”œβ”€β”€ models/    # SQLAlchemy ORM
β”‚   β”‚   β”œβ”€β”€ services/  # Business logic (MRP, etc)
β”‚   β”‚   └── core/      # Config, security
β”‚   └── tests/
β”œβ”€β”€ frontend/          # React admin UI
β”œβ”€β”€ docs/              # Documentation
└── docker-compose.yml

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

Good first issues:

  • Bug fixes
  • Documentation improvements
  • UI/UX polish
  • Test coverage

License

Business Source License 1.1 β€” see LICENSE

  • βœ… Free for internal business use
  • βœ… Free for personal and educational use
  • ❌ Cannot offer FilaOps as a hosted service to others
  • πŸ”“ Converts to Apache 2.0 after 4 years

Support


Built by BLB3D β€” a print farm that needed real manufacturing software.