A humorous nod to the Star Trek Enterprise HoloDeck — but instead of virtual reality, we create virtual clarity for automotive type-approval.
🚧 This project is under active development. APIs, file formats, and features may change. Contributions and feedback are welcome!
Holo (short for Homologation) is an open-source platform that collects, catalogs, extracts, and structures automotive homologation (type-approval) requirements from regulatory documents across the globe.
The automotive industry needs to comply with a vast, ever-evolving set of regulations from dozens of national and international bodies. These documents are often written as dense legal prose — making it hard for engineers and compliance teams to extract precise, testable requirements. Holo automates that process.
| Goal | Description |
|---|---|
| 📚 Catalog | Collect all homologation-relevant regulatory sources globally |
| 🤖 Extract | Use AI to extract named, classified requirements from regulatory prose |
| 🔍 Trace | Enable OFT (Object-Function Tracing) from regulation to implementation |
| 🌐 Serve | Provide an MCP Server for Q&A on homologation requirements |
| 📊 Dashboard | Visual overview of compliance status and requirement coverage |
- 🇺🇸 North America: FMVSS, CMVSS (Canada)
- 🇪🇺 Europe: UNECE Regulations, EU Directives, KBA/TÜV standards
- 🇯🇵 Japan: JASO, MLIT standards
- 🇰🇷 Korea: KMVSS
- 🇨🇳 China: GB standards (CCC)
- 🌏 Global: ISO, SAE International standards
regulations/ # Raw & linked regulatory source documents
processed-regulations/ # MarkItDown-converted text (generated, gitignored)
src/
extractor/ # AI-powered requirements extractor
mcp-server/ # MCP Server for Q&A on requirements
compliance-checker/ # Compliance check engine
dashboard/ # Web dashboard (GitHub Pages)
docs/ # Project documentation
.github/workflows/ # Automated regulation update pipelines
See docs/architecture.md for details.
The primary way to use Holo is locally. Clone the repo, optionally add your own standards, and run the top-level runner:
# 1. Clone
git clone https://github.com/quarterbit/Holo.git
cd Holo
# 2. Install dependencies (Python 3.11+)
pip install -r src/extractor/requirements.txt
# 3. (Optional) Add custom standards
# Drop PDFs, HTML, DOCX, or a catalog.json into:
# regulations/custom/
# 4. Run Holo — extracts all standards and serves the dashboard
python holo.py
# → Dashboard opens at http://localhost:8080
# 5. Or serve the dashboard without re-extracting (uses bundled sample data)
python holo.py --serve
# 6. Or process a single standard only
python holo.py --standard FMVSS-111AI provider — set your API key before running:
export OpenAI_KEY=sk-... # default (gpt-4o)
export ANTHROPIC_API_KEY=sk-ant-... # or: python holo.py --ai anthropicNo API key? Run
python holo.py --serveto explore the dashboard with bundled sample data. All filtering and navigation work without extraction.
Holo provides an MCP (Model Context Protocol) Server that can be embedded in AI assistants to answer homologation questions:
"What are the rear-camera display timing requirements when the vehicle moves forward?"
See src/mcp-server/README.md for setup instructions.
The Holo dashboard provides:
- Visual catalog of all covered regulations
- OFT (Object-Function Tracing) matrix
- Compliance status per region/vehicle type
- Requirement diff between regulatory versions
Live at: https://quarterbit.github.io/Holo
Holo's document extraction pipeline is powered by MarkItDown from Microsoft — a versatile utility that converts PDF, Office (DOCX, XLSX, PPTX), HTML, and image files into clean Markdown. MarkItDown runs locally with no GPU or Java required, keeping sensitive regulatory content private. It's an excellent fit for Holo's mission of turning dense legal prose into structured, testable requirements.
We welcome contributions of new regulatory sources, improved extractors, and bug fixes. See CONTRIBUTING.md for guidelines.
This project is licensed under the Apache License 2.0 — see LICENSE.
Note on regulatory documents: We only host regulatory documents where their license explicitly permits redistribution. All linked external documents remain subject to their original licenses.