OBT (Orkid Build Tool)
Build environment orchestrator for complex multi-language projects
What is OBT?
OBT manages build environments for complex software projects with extensive dependency trees. Unlike package managers that install system-wide, OBT creates isolated staging environments where all your project dependencies coexist without polluting your system.
Key Features
- 🔧 100+ Pre-configured Dependencies - Boost, Qt5, OpenCV, LLVM, and more
- 🎯 Project Composition - Combine multiple projects with
--projectarguments - 🌍 Cross-Platform - Identical commands on Linux, macOS, and WSL2
- 🏗️ Multi-Language - C++, Python, Rust, JavaScript, and more
- 📦 Isolated Environments - No system pollution, everything in staging directories
- 🎨 Extensible - Add custom dependencies and modules per project
Quick Start
# Install OBT
pip3 install ork.build
# Create environment
obt.env.create.py --stagedir ~/.obt-staging
# Launch with projects
obt.env.launch.py --stagedir ~/.obt-staging --numcores 16 \
--project ~/projects/myproject \
--project ~/projects/shared
# Build dependencies
obt.dep.build.py boost
obt.dep.build.py opencv
Documentation
Getting Started
- 📚 Quick Start Guide - Get up and running in minutes
- 🎯 Examples - Real-world usage patterns
Reference
- 📖 Technical Design Document - Architecture, concepts, and FAQ
- 🏗️ Project Composition - How projects integrate
Advanced Topics
- 🐳 Docker Support - Containerized development environments
- 🔮 Subspaces - Isolated execution environments
- ⚡ FPGA/Vivado - Hardware development support
Requirements
- Python 3.10+
- Virtual environment (PEP-668 compliance)
- Clean base shell environment (why?)
Platform-Specific
macOS: Xcode, Homebrew
Linux: Build essentials, sudo access
Windows: WSL2 with Ubuntu
Project Composition
Make any project OBT-aware by adding:
myproject/
├── obt.project/
│ ├── obt.manifest # {"name": "myproject", "autoexec": "scripts/init_env.py"}
│ └── scripts/
│ └── init_env.py # Environment setup script
Then compose multiple projects:
obt.env.launch.py --project project1 --project project2 --project project3
Philosophy
OBT doesn't replace package managers or build systems - it orchestrates them. When you need a library, you need it. OBT ensures you get it with the right version, in the right place, without breaking anything else.
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
License
BSD 3-Clause License - See LICENSE and license.rst for details.
Copyright (c) 2010-2024, Michael T. Mayers. All rights reserved.
1 maintainer
Metadata
1 maintainer
Release files for ork.build 0.0.318
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ork_build-0.0.318.tar.gz | 635.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ork_build-0.0.318-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / ork_build-0.0.318.tar.gz
| Download URL | ork_build-0.0.318.tar.gz |
|---|---|
| Size | 635.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3daf9d2b7145d8504ae408d26bf8399d8dd8c3ece2db858a35e58d16b6c3c9b
|
|
BLAKE2b-256 checksum How to use checksums |
7674e33c365c9c16288850a47861421517c24ebee06f2ebbcecf9d4144338afd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / ork_build-0.0.318-py3-none-any.whl
| Download URL | ork_build-0.0.318-py3-none-any.whl |
|---|---|
| Size | 923.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b00fac2ca0e8d51dd76c03c10885720b9e1ecd109de2c83786274f86707ea4b0
|
|
BLAKE2b-256 checksum How to use checksums |
3b096cd7d1a33edac74dac084cd7a1fc1b7f7af00e8ddf1c7519db66af65ab91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
