TGC Business Utility System — BUS Core (Beta)

A local-first inventory and manufacturing system for small shops and solo makers.

No cloud. No accounts. No subscriptions.
Your data stays on your machine.

---

What Is BUS Core?

BUS Core is designed for workshops that build real things in small batches.

It replaces:

• Spreadsheets
• Paper logs
• Ad-hoc tracking systems
• Expensive SaaS platforms

With:

• One local database
• Real production costing
• Full audit history
• Complete data ownership

It is built for operators who want control, not dashboards.

---

Who BUS Core Is For

• Small manufacturing shops (1–20 people)
• Makerspaces
• Custom fabricators
• Repair and prototyping shops
• Solo operators

If you build physical products in low to medium volume, BUS Core is for you.

---

What It Tracks

• Materials & Consumables
  Track stock by unit (grams, millimeters, milliliters, each), with batch numbers, cost, and purchase dates.

• Blueprints (Recipes)
  Define how materials become products. Costs are calculated using FIFO from real purchase batches.

• Assemblies & Products
  Build items from blueprints, set prices, and compare real costs to sales.

• Vendors
  Track supplier pricing and purchasing history over time.

BUS Core focuses on operations and production costing.
It is not a full accounting system—and is not trying to be.

---

Key Features

• Open Source — 100% free (AGPLv3)
• Precision Inventory — FIFO batch valuation with metric units
• Manufacturing Engine — Recipe-based builds with atomic commits
• Ledger & Audit Trail — Complete movement history
• Local & Private — SQLite database with encrypted backups
• Cross-Platform — Windows, Linux, and macOS

---

Getting Started

Prerequisites

• Windows (primary support)
• Linux / macOS (supported via Docker)

---

Installation (Windows)

1. Download the latest release.
2. Run the .exe file.
3. No installer required.

Note: Until code signing is complete, Windows Defender may warn on first run.

The application runs in the system tray.
Double-click the tray icon to open the dashboard.

---

Development Mode

Enable development features by setting:

BUS_ENV=dev

This enables:

• Console output
• Debug endpoints
• Smoke tests (scripts/smoke.ps1)

Development scripts are included in the source tree.

---

Architecture

See docs/SOT.md for the canonical Source of Truth and system architecture.

---

Interface Gallery

Dashboard	Inventory

Manufacturing	Recipes

Logs	Settings

---

Run with Docker

docker pull ghcr.io/true-good-craft/tgc-bus-core:latest

docker run -p 8765:8765 ghcr.io/true-good-craft/tgc-bus-core:latest

(Docker is optional. Native Windows builds are supported.)

Auto-Open Scripts

Windows

scripts\up.ps1

macOS / Linux

./scripts/up.sh

Health Check

curl http://localhost:8765/health

UI:

http://localhost:8765/ui/shell.html#/home

Stop

docker compose down
# or
docker rm -f bus-core

---

Run Natively (Windows)

Docker is optional.

pip install -r requirements.txt

python -m uvicorn core.api.http:create_app \
  --factory \
  --host 0.0.0.0 \
  --port 8765

UI:

http://localhost:8765/ui/shell.html#/home

---

Data & Persistence

• All data is stored locally in SQLite.
• Docker deployments persist data in /data.
• Default database path:

BUS_DB=/data/app.db

Backups can be encrypted using AES-GCM.

---

Philosophy

BUS Core is built on three principles:

1. Local-first by default
2. No artificial limits
3. User owns their data

Software should serve small operators, not extract from them.

---

License

BUS Core is licensed under the GNU AGPLv3.

You are free to use, modify, and self-host it. If you offer it as a network service, you must provide source access.

See LICENSE for details.

https://buscore.ca

Maintained by True Good Craft (Canada)