Skip to content

TStrathaus/OpenConstructionERP

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

401 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

OpenConstructionERP

The #1 Open-Source Construction Estimation & Project Management Software

Professional BOQ, 4D/5D planning, AI-powered estimation, CAD/BIM takeoff — all in one platform.

Demo · Documentation · Discussions · Report Bug

License Version Languages Cost Items Standards

OpenConstructionERP — Dashboard Overview

100% open source · 55,000+ cost items · AI estimation · 21 languages · Self-hosted


Table of Contents

Getting Started

Core Modules

Planning & Delivery

Field Tools

Standards & Regions

Technical


Why OpenConstructionERP?

Construction cost estimation software is expensive, closed-source, and locked to specific regions. OpenConstructionERP changes that.

What you get How it works
Free forever AGPL-3.0 license. No subscriptions, no per-seat fees, no vendor lock-in.
Your data, your server Self-hosted. Everything runs on your machine — nothing leaves your network.
21 languages Full UI translation: English, German, French, Spanish, Portuguese, Russian, Chinese, Arabic, Hindi, Japanese, Korean, and 10 more.
20 regional standards DIN 276, NRM 1/2, CSI MasterFormat, GAEB, ГЭСН, DPGF, GB/T 50500, CPWD, and more.
AI-powered Connect any LLM provider (Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek) for smart estimation.
55,000+ cost items CWICR database with 11 regional pricing databases (DACH, UK, US, France, Spain, Brazil, Russia, UAE, China, India, Canada).

How It Compares

Capability OpenConstructionERP Typical Proprietary Estimating Typical Takeoff Tool
LicenseAGPL-3.0 (free)ProprietaryProprietary
Self-hosted / offline✖ cloud only
PriceFree forever€200-500/mo per seat€30-100/mo per seat
AI estimation✔ 16 LLM providers
UI languages212-53-8
Regional standards201-4
BOQ editor
CAD/BIM takeoff✔ RVT IFC DWG DGN✔ PDF only
4D/5D planning⚠ limited
Cost database included✔ 55K+ items with rates✖ extra cost
Resource catalog✔ 7K+ with prices✖ extra cost
Validation engine✔ 42 rules⚠ limited
REST API✔ full access⚠ limited

What's New in v0.9.0

30 new modules — contacts, finance, procurement, tasks, meetings, safety, inspections, RFI, submittals, NCR, correspondence, CDE (ISO 19650), transmittals, BIM Hub, reporting, and more.

SVG Gantt chart — day/week/month zoom, dependency arrows, critical path highlighting, drag-to-reschedule.

BIM Viewer — Three.js viewer with discipline coloring, element selection, properties panel. Upload CSV/Excel element data + DAE geometry, or raw CAD files (RVT, IFC, DWG, DGN).

16 AI providers — Anthropic, OpenAI, Google Gemini, Mistral, Groq, DeepSeek, OpenRouter, Together, Fireworks, Perplexity, Cohere, AI21, xAI, Zhipu, Yandex GPT, Baidu.

8 regional packs — US (AIA/CSI), DACH (DIN 276/GAEB/VOB), UK (NRM2/JCT/NEC4), Russia, Middle East (FIDIC), Asia-Pacific, India, Latin America.

Import/export everywhere — contacts CSV import with template, budget Excel import, safety/inspection/RFI Excel exports, meeting minutes PDF export, AI meeting transcript import (Teams/Meet/Zoom).

ISO 19650 CDE — document containers with WIP->Shared->Published->Archived workflow, OpenCDE BCF 3.0 API compliance.

568 translation keys x 20 languages — professional construction terminology in German, French, Spanish, Russian, Chinese, Arabic, Japanese, and 13 more.


Complete Estimation Workflow

OpenConstructionERP covers the full lifecycle — from first sketch to final tender submission:

  Upload              Convert            Validate           Estimate           Tender
 ┌────────┐        ┌──────────┐       ┌───────────┐      ┌──────────┐      ┌──────────┐
 │PDF/CAD │───────▶│ Extract  │──────▶│ 42 rules  │─────▶│BOQ Editor│─────▶│ Bid Pkgs │
 │Photo   │        │quantities│       │ DIN/NRM/  │      │ + AI     │      │ Compare  │
 │Text    │        │ + AI     │       │ MasterFmt │      │ + Costs  │      │ Award    │
 └────────┘        └──────────┘       └───────────┘      └──────────┘      └──────────┘
                                                               │
                                                         ┌─────┴──────┐
                                                         │ 4D Schedule│
                                                         │ 5D Costs   │
                                                         │ Risk Reg.  │
                                                         │ Reports    │
                                                         └────────────┘

If you want to see new updates and database versions and if you find our tools useful please give our repositories a star to see more similar applications for the construction industry. Star OpenConstructionERP on GitHub and be instantly notified of new releases.





Key Features

📊 Bill of Quantities (BOQ) Management

BOQ Editor — Create, manage and analyze Bills of Quantities

Build professional cost estimates with a powerful BOQ editor:

  • Hierarchical BOQ structure — Sections, positions, sub-positions with drag-and-drop reordering
  • Inline editing — Click any cell to edit. Tab between fields. Undo/redo with Ctrl+Z
  • Resources & assemblies — Link labor, materials, equipment to each position. Build reusable cost recipes
  • Markups — Overhead, profit, VAT, contingency — configure per project or use regional defaults
  • Automatic calculations — Quantity × unit rate = total. Section subtotals. Grand total with markups
  • Validation — 42 built-in rules check for missing quantities, zero prices, duplicate items, and compliance with DIN 276, NRM, MasterFormat
  • Export — Download as Excel, CSV, PDF report, or GAEB XML (X83)

🗄️ Cost Databases & Resource Catalog

Cost Database — 55,000+ items across 11 regions

Access the world's construction pricing data:

  • CWICR database — 55,000+ cost items covering all major construction trades. Available in 9 languages with 11 regional price sets
  • Smart search — Find items by description, code, or classification. AI-powered semantic search matches meaning, not just keywords ("concrete wall" finds "reinforced partition C30/37")
  • Resource catalog — 7,000+ materials, equipment, labor rates, and operators. Build custom assemblies from catalog items
  • Regional pricing — Automatic price adjustment based on project location. Compare rates across regions
  • Import your data — Upload your own cost database from Excel, CSV, or connect via API

🏗️ CAD/BIM Takeoff & AI Estimation

CAD/BIM Takeoff and AI-powered estimation

Extract quantities from any source — drawings, models, text, or photos:

  • CAD/BIM takeoff — Upload Revit (.rvt), IFC, AutoCAD (.dwg), or MicroStation (.dgn) files. DDC converters extract elements with volumes, areas, and lengths automatically
  • Interactive QTO — Choose how to group extracted data: by Category, Type, Level, Family. Format-specific presets for Revit and IFC
  • PDF measurement — Open construction drawings directly in the browser. Measure distances, areas, and count elements with calibrated scale
  • AI estimation — Describe your project in plain text, upload a building photo, or paste a PDF — AI generates a complete BOQ with quantities and market rates
  • AI Cost Advisor — Ask questions about pricing, materials, or estimation methodology. AI answers using your cost database as context
  • Cost matching — After AI generates an estimate, match each item against your CWICR database to replace AI-guessed rates with real market prices

📅 4D Scheduling & 5D Cost Model

Plan your project timeline and track costs over time:

  • Gantt chart — Visual project schedule with drag-and-drop activities, dependencies (FS/FF/SS/SF), and critical path highlighting
  • Auto-generate from BOQ — Create schedule activities directly from your BOQ sections with cost-proportional durations
  • Earned Value Management — Track SPI, CPI, EAC, and variance. S-curve visualization shows planned vs actual progress
  • Budget tracking — Set baselines, compare snapshots, run what-if scenarios
  • Monte Carlo simulation — Risk-adjusted schedule analysis with probability distributions

📋 Tendering, Risk & Reporting

Complete your estimation workflow:

  • Tendering — Create bid packages, distribute to subcontractors, collect and compare bids with side-by-side price mirror
  • Change orders — Track scope changes with cost and schedule impact analysis
  • Risk register — Probability × impact matrix, mitigation strategies, risk-adjusted contingency
  • Reports — Generate professional PDF reports, Excel exports, GAEB XML. 12 built-in templates
  • Documents — Centralized file management with version tracking and drag-and-drop upload

📝 Requirements & Quality Gates

Track and validate construction requirements with the EAC (Entity-Attribute-Constraint) system:

  • EAC Triplets — Capture requirements as structured data: Entity (wall), Attribute (fire_rating), Constraint (≥ F90)
  • 4 Quality Gates — Completeness → Consistency → Coverage → Compliance. Run sequentially to validate requirements
  • BOQ Traceability — Link each requirement to BOQ positions for full traceability from spec to estimate
  • Bulk Import — Import requirements from structured text (pipe-delimited format)
  • Categories — Structural, fire safety, thermal, acoustic, waterproofing, electrical, mechanical, architectural

✏️ PDF Markups & Annotations

Annotate construction drawings and documents directly in the browser:

  • 10 markup types — Cloud, arrow, text, rectangle, highlight, polygon, distance, area, count, stamp
  • Custom stamps — Approved, Rejected, For Review, Revised, Final + create your own with logo and date
  • Scale calibration — Set real-world scale per page for accurate measurements
  • Markups List — Table view of all annotations with filters, search, and CSV export
  • BOQ Integration — Link measurements directly to BOQ positions (quantity = measured value)

✅ Punch List

Track construction deficiencies from discovery to resolution:

  • 5-stage workflow — Open → In Progress → Resolved → Verified → Closed
  • Location pins — Mark exact position on PDF drawings (x/y coordinates)
  • Priority levels — Low, Medium, High, Critical with color coding
  • Photo attachments — Upload photos of deficiencies from the field
  • Categories — Structural, mechanical, electrical, architectural, fire safety, plumbing, finishing
  • PDF Export — Generate punch list reports for stakeholder review
  • Verification control — Different user must verify (not the resolver)

🌍 20 Regional Standards

Standard Region Format
DIN 276 / ÖNORM / SIA Germany / Austria / Switzerland Excel, CSV
NRM 1/2 (RICS) United Kingdom Excel, CSV
CSI MasterFormat United States / Canada Excel, CSV
GAEB DA XML 3.3 DACH region XML
DPGF / DQE France Excel, CSV
ГЭСН / ФЕР Russia / CIS Excel, CSV
GB/T 50500 China Excel, CSV
CPWD / IS 1200 India Excel, CSV
Bayındırlık Birim Fiyat Turkey Excel, CSV
積算基準 (Sekisan) Japan Excel, CSV
Computo Metrico / DEI Italy Excel, CSV
STABU / RAW Netherlands Excel, CSV
KNR / KNNR Poland Excel, CSV
표준품셈 South Korea Excel, CSV
NS 3420 / AMA Nordic countries Excel, CSV
ÚRS / TSKP Czech Republic / Slovakia Excel, CSV
ACMM / ANZSMM Australia / New Zealand Excel, CSV
CSI / CIQS Canada Excel, CSV
FIDIC UAE / GCC Excel, CSV
PBC / Base de Precios Spain Excel, CSV

🛡️ Validation & Compliance Engine

Ensure your estimates meet regulatory standards before submission:

  • 42 built-in rules across 13 rule sets — DIN 276, NRM, MasterFormat, GAEB, and universal BOQ quality checks
  • Real-time validation — Run checks with Ctrl+Shift+V. Each position gets a pass/warning/error indicator
  • Quality score — Overall BOQ quality percentage (0–100%) visible in the toolbar
  • Drill-down — Click any finding to jump directly to the affected BOQ position and fix it
  • Custom rules — Define project-specific validation rules via the rule builder or Python scripting

🚀 Guided Onboarding

Get productive in under 10 minutes:

  1. Choose language — Select from 21 languages. The entire UI switches instantly
  2. Select region — Determines default cost database, currency, and classification standard
  3. Load cost database — One-click import of CWICR pricing data for your region (55,000+ items)
  4. Import resource catalog — Materials, labor, equipment, and pre-built assemblies
  5. Configure AI (optional) — Enter an API key from any supported LLM provider
  6. Create your first project — Set name, region, standard, and start estimating

Quick Start

The fastest way to run OpenConstructionERP locally — three commands, no Docker, no database setup:

pip install openconstructionerp
openestimate init-db
openestimate serve

That's it. Open http://localhost:8080 in your browser and log in with the demo account below.

Requires Python 3.12+ (check with python --version). Uses SQLite by default — no PostgreSQL, no Redis, no Docker required. The frontend is bundled inside the wheel, so a single pip install gets you the full app (backend + UI). Total install size: ~30 MB.

What you should see when it works

  ___                  ____                _                   _   _
 / _ \ _ __   ___ _ _ / ___|___  _ __  ___| |_ _ _ _   _  ___ | |_(_) ___  _ _
| | | | '_ \ / _ \ '_| |   / _ \| '_ \/ __| __| '_| | | |/ __|| __| |/ _ \| '_ \
| |_| | |_) |  __/ | | |__| (_) | | | \__ \ |_| |  | |_| | (__ | |_| | (_) | | | |
 \___/| .__/ \___|_|  \____\___/|_| |_|___/\__|_|   \__,_|\___(_)__|_|\___/|_| |_|
      |_|                                                             ERP

  OpenConstructionERP v1.3.11
  Open-source construction cost estimation platform

  Open in your browser:  http://127.0.0.1:8080
  API docs:              http://127.0.0.1:8080/api/docs

  Demo login (auto-created on first run)
    Email:    demo@openestimator.io
    Password: DemoPass1234!

  Data directory: ~/.openestimate
  Stop the server: Ctrl+C
  Need help: https://openconstructionerp.com/docs

The first run takes 10–30 seconds while the server creates the SQLite database and seeds five demo projects. Subsequent runs start in 2–3 seconds.

Other install options

Open browser automatically
openestimate serve --open
Custom port or data directory
openestimate serve --port 9000 --data-dir ~/my-erp-data
Docker (PostgreSQL + Redis + MinIO)
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstart

Open http://localhost:8080 — builds everything in ~2 minutes. Recommended for multi-user deployments.

One-line installer (auto-detects Docker / Python / uv)
# Linux / macOS
curl -sSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iex
Local development from a git checkout
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP

# Backend
cd backend && pip install -r requirements.txt && cd ..

# Frontend
cd frontend && npm install && npm run build && cd ..

# Run
cd backend && uvicorn app.main:create_app --factory --reload --port 8000

Open http://localhost:8000. Requires Python 3.12+ and Node.js 20+.

Troubleshooting

If openestimate serve doesn't work, run openestimate doctor first — it checks the top failure modes and tells you exactly what to fix.

Symptom Likely cause Fix
Python 3.X is too old Python below 3.12 Install Python 3.12+ from python.org
port 8080 is already in use Another app on port 8080 openestimate serve --port 9000
cannot write to ~/.openestimate Locked-down home directory openestimate serve --data-dir /tmp/erp-data
Process exits silently on Windows + Anaconda torch/MKL DLL conflict (fixed in v1.3.10) Upgrade: pip install -U openconstructionerp
command not found: openestimate Scripts dir not on PATH Use python -m app or add ~/.local/bin to PATH
no frontend found Wheel was built without bundled UI pip install --force-reinstall openconstructionerp
AI estimation buttons disabled Optional [ai] extras not installed pip install 'openconstructionerp[ai]'
Semantic search disabled Optional [vector] extras not installed pip install 'openconstructionerp[vector]'

For anything else, copy the output of openestimate doctor into a GitHub issue.

Demo Accounts

Three demo accounts are created automatically on first start:

Account Email Password Role
Admin demo@openestimator.io DemoPass1234! Full access
Estimator estimator@openestimator.io DemoPass1234! Estimator
Manager manager@openestimator.io DemoPass1234! Manager

Demo accounts include 5 pre-loaded projects from Berlin, London, New York, Paris, and Dubai with complete BOQs, schedules, and cost models.


Tech Stack

Layer Technology Purpose
Backend Python 3.12+ / FastAPI Async API, Pydantic v2 validation, modular architecture
Frontend React 18 / TypeScript / Vite SPA with code splitting, 21 language bundles
Database PostgreSQL 16+ / SQLite (dev) OLTP with JSON columns, zero-config SQLite for development
UI Tailwind CSS / AG Grid Professional data grid, responsive design, dark mode
AI Any LLM via REST API Anthropic, OpenAI, Gemini, Mistral, Groq, DeepSeek
Vector Search LanceDB (embedded) / Qdrant Semantic cost item search, 384d or 3072d embeddings
CAD/BIM DDC cad2data RVT, IFC, DWG, DGN → structured quantities
i18n i18next + 21 language packs Full RTL support (Arabic), locale-aware formatting

Architecture

┌──────────────────────────────────────────────────┐
│  Frontend (React SPA)                            │
│  TypeScript · Tailwind · AG Grid · PDF.js        │
└──────────────────┬───────────────────────────────┘
                   │ REST API
┌──────────────────┴───────────────────────────────┐
│  Backend (FastAPI)                               │
│  20 auto-discovered modules · Plugin system      │
├──────────────────────────────────────────────────┤
│  BOQ · Costs · Schedule · 5D · Validation · AI  │
│  Takeoff · Tendering · Risk · Reports · Catalog  │
│  Requirements · Markups · Punch List             │
├──────────────────────────────────────────────────┤
│  Database (PostgreSQL / SQLite)                  │
│  Vector DB (LanceDB / Qdrant)                    │
│  CAD Converters (DDC cad2data)                   │
└──────────────────────────────────────────────────┘

Support the Project

OpenConstructionERP is built and maintained by the community. If you find it useful:

Security

OpenConstructionERP includes security hardening for production deployments:

  • Path traversal protection on all file download endpoints
  • CORS wildcard blocking in production mode
  • Bounded input validation on bulk price operations
  • Generic error responses to prevent account enumeration
  • Production startup checks for secrets, credentials, and database configuration

Report vulnerabilities via GitHub Issues (private reports supported).

Contributing

We welcome contributions! See CONTRIBUTING.md for development guidelines, code style, and PR process.

License

AGPL-3.0 — see LICENSE.

You can freely use, modify, and distribute this software. If you modify and deploy it as a service, you must make your source code available under the same license.

For commercial licensing without AGPL obligations, contact info@datadrivenconstruction.io.


Created by Artem Boiko · Data Driven Construction

Building open-source tools for the global construction industry.

Website · LinkedIn · YouTube · GitHub

About

The #1 open-source platform for construction cost estimation. BOQ, 4D/5D, AI, CAD/BIM takeoff, 21 languages, 55K+ cost items

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 62.6%
  • Python 33.6%
  • HTML 3.3%
  • CSS 0.3%
  • JavaScript 0.1%
  • Shell 0.1%