dct-os 0.1.0

Daily cost tracking for civil engineering

DCT-OS

Daily cost tracking, done right.

DCT-OS is a cost tracking platform built for civil engineering — project managers, site engineers, and contractors who need to track daily costs without fighting enterprise software. SQLite-backed, self-hostable, and ready to deploy.

Features

• Project and cost code management
• Daily docket entry with resource rate lookups
• PDF-assisted manual entry (PDF viewer + form side-by-side)
• Project summary, cost code breakdown, and supplier spend reports
• CSV and Excel export
• REST API for all operations
• Single binary or pip install — runs anywhere

Installation (Windows)

You only need to do this once. After that, DCT-OS starts automatically every time you turn on your computer.

Option A: Let Claude do it

If you have Claude Code installed, open it and paste this:

Install DCT-OS for me. Run: pip install dct-os, then run: dct-os install.
If Python isn't installed, download and install it from python.org first
(make sure "Add Python to PATH" is ticked). After install, run: dct-os
to start it and open the browser.

Claude will handle the rest. Once it's done, bookmark http://localhost:5000 and you're set.

Option B: Do it yourself

Step 1: Install Python

1. Go to python.org/downloads
2. Click the big yellow Download Python button
3. Run the installer
4. Important: Tick the box that says "Add Python to PATH" at the bottom of the first screen
5. Click Install Now and wait for it to finish

Step 2: Install DCT-OS

1. Press the Windows key, type cmd, and press Enter to open a command prompt
2. Type the following and press Enter:

pip install dct-os

Wait for it to finish (you'll see some download progress, then it returns to the blinking cursor).

3. Type the following and press Enter:

dct-os install

You'll see a confirmation message. That's it. You're done with the command prompt and can close it.

Step 3: Start DCT-OS

Type the following and press Enter:

dct-os

Your browser will open to DCT-OS with demo data loaded. Have a click around.

From now on, DCT-OS starts automatically when you log in to Windows. No command prompt needed. Just open your browser and go to:

http://localhost:5000

Tip: Bookmark that address. It's your DCT-OS.

Updating

When a new version is available, a banner will appear at the top of DCT-OS. To update:

1. Open a command prompt (Windows key, type cmd, Enter)
2. Type:

pip install --upgrade dct-os

3. Close the command prompt. DCT-OS will use the new version next time it starts.

Your data is never touched during updates.

Uninstalling

To stop DCT-OS from starting automatically (your data is kept):

dct-os uninstall

To fully remove:

pip uninstall dct-os

Your database stays in your user folder at %LOCALAPPDATA%\DCT-OS\ unless you delete it manually.

---

Quick Start (for developers)

pip install dct-os
dct-os

Your browser opens automatically to http://localhost:5000. Demo data loads on first run.

Auto-start on Windows

dct-os install     # creates a silent startup entry
dct-os uninstall   # removes it (keeps your data)

Install from source

git clone https://github.com/h3ylis/dct-os.git
cd dct-os
pip install -e .
dct-os

Options

Environment variable	Default	Description
DCT_PORT	5000	Server port
DCT_HOST	127.0.0.1	Bind address
DCT_DATA_DIR	. (current dir)	Where to store the database
DCT_NO_SEED	unset	Set to 1 to start with an empty database

Licence and Use

DCT-OS is released under the Business Source License 1.1.

What this means:

• Free for internal use — engineers, contractors, and organisations running it for their own cost tracking. Modify it, deploy it internally, use it on every project. No cost, no limits, no phone-home.
• Commercial licence required for hosted or embedded use — if you're offering DCT-OS to third parties as a service, bundling it into a product you sell, or reselling it, you need a commercial licence.
• Converts to Apache 2.0 after four years per release — every version eventually becomes fully open under the Apache Licence.

See LICENSING.md for the full breakdown of what's free and what needs a commercial licence.

For commercial licensing enquiries: [e-mail]

Contributing

We welcome contributions. A Contributor Licence Agreement (CLA) is being configured — please open an issue for discussion before submitting pull requests.

See CONTRIBUTING.md for details.

Contact

• Commercial licensing: [e-mail]
• Bug reports and feature requests: GitHub Issues