The Orb - Ecosystem meta-project for Bodai
Project description
Bodai
Central meta-project for the Bodai ecosystem, providing configuration, documentation, and operations for all components.
ORB: Orchestrated Reasoning Brain
Perceive. Reason. Orchestrate.
Etymology: From Sanskrit bodhi (awakening, enlightenment) - the state of supreme understanding.
Quick Links
- Ecosystem Components
- Mahavishnu - The Orchestrator
- Akosha - The Seer
- Dhara - The Curator
- Crackerjack - The Inspector
Quality & CI
Crackerjack is the Bodai ecosystem's standard quality-control and CI/CD runner. Repo-level quality gates should align with Crackerjack workflows unless a repo documents an exception.
Ecosystem Components
The Bodai ecosystem consists of nine interconnected components, each with a distinct role. Seven are network services with MCP servers, while Oneiric and SplashStand serve as shared libraries.
Note: SplashStand and MDInject are proprietary components. All other components are open source (MIT license).
| Component | Role | Port | GitHub | Description |
|---|---|---|---|---|
| Mahavishnu | Orchestrator | 8680 | lesleslie/mahavishnu | Multi-engine workflow orchestration |
| Akosha | Seer | 8682 | lesleslie/akosha | Cross-system intelligence & vector embeddings |
| Dhara | Curator | 8683 | lesleslie/dhara | Persistent object storage with ACID |
| Session-Buddy | Builder | 8678 | lesleslie/session-buddy | Session lifecycle & knowledge graphs |
| Crackerjack | Inspector | 8676 | lesleslie/crackerjack | Quality gates & CI/CD validation |
| FastBlocks | Composer | 8684 | lesleslie/fastblocks | Block-based web framework |
| SplashStand | Presenter | N/A | Private | PWA & mini-CMS built on FastBlocks |
| MDInject | Doctor | 8685 | Private | Markdown injection & healing |
| Oneiric | Foundation | N/A | lesleslie/oneiric | Component resolution, lifecycle management, adapter system, action kits, domain bridges, runtime orchestration, remote delivery |
Mahavishnu - The Orchestrator
From Sanskrit maha (great) + Vishnu (the preserver in Hindu trinity)
The central workflow engine that routes tasks to appropriate execution engines, coordinates multi-step processes across components, and manages workflow definitions and templates.
- Routes tasks to Akosha for intelligence operations
- Persists state to Dhara for recovery
- Tracks context in Session-Buddy
- Validates with Crackerjack before execution
Akosha - The Seer
From Sanskrit akasha (sky, ether, space) - the fifth element, medium of consciousness
Provides cross-system intelligence through vector embeddings, semantic search, pattern detection, and knowledge graphs. Enables predictive analysis and recommendations across all sessions.
- Receives session data from Session-Buddy for embedding
- Stores patterns in Dhara
- Provides intelligence to Mahavishnu
- Receives code analysis from Crackerjack
Dhara - The Curator
From Sanskrit dhara (firm, constant, unchanging) - also the Pole Star
The single source of truth for persistent data. Provides ACID transaction guarantees, data versioning, backup/recovery, and efficient querying.
- Stores state for Mahavishnu
- Persists patterns for Akosha
- Backs up sessions for Session-Buddy
- Stores quality reports for Crackerjack
Session-Buddy - The Builder
The session lifecycle manager that tracks conversation history, builds knowledge graphs, and enables context switching between sessions.
- Sends data to Akosha for embedding
- Stores backups in Dhara
- Provides context to Mahavishnu
- Receives quality metrics from Crackerjack
Crackerjack - The Inspector
The quality enforcer that runs automated test suites, manages CI/CD pipelines, provides code analysis and linting, and tracks quality metrics over time.
- Validates workflows for Mahavishnu
- Sends code analysis to Akosha
- Stores reports in Dhara
- Records metrics in Session-Buddy
FastBlocks - The Composer
A composer arranges musical notes into harmonious compositions
A block-based web framework that composes pages from reusable blocks, manages template inheritance, and provides a style adapter system for multiple frameworks (Kelp, WebAwesome, etc.).
- Sends rendered output to SplashStand for presentation
- Requests content validation from MDInject
- Stores templates in Dhara
- Tracks composition metrics in Session-Buddy
SplashStand - The Presenter
A presenter displays content on a stand for viewing
A high-level progressive web application and mini-CMS built on FastBlocks. Manages content, responsive layouts, themes, and ensures accessibility compliance.
- Built on FastBlocks for composition
- Applies styles from FastBlocks adapters
- Logs presentation metrics to Session-Buddy
- Uses Oneiric for style conflict resolution
MDInject - The Doctor
A doctor diagnoses ailments and administers treatments
The markdown health service that injects dynamic content, diagnoses issues, heals malformed content, and validates syntax.
- Validates content from FastBlocks
- Sends diagnostics to Crackerjack for quality gates
- Stores healed content in Dhara
- Logs health metrics to Session-Buddy
Oneiric - The Foundation
From Greek oneiros (dream) - relating to dreams, the abstract and complex
The platform foundation library that provides explainable component resolution, lifecycle management, an adapter system spanning 18+ domains, action kits for automation, domain bridges (services/tasks/events/workflows), runtime orchestration, and remote delivery via signed manifests. Every other Bodai component builds on top of Oneiric's patterns.
- Used by Mahavishnu for layered configuration and lifecycle management
- Used by mcp-common as the Oneiric-native foundation for all MCP servers
- Used by Dhara for configuration, logging, and secrets management
- Used by Session-Buddy for storage adapters, configuration, and lifecycle
- Used by Crackerjack for runtime orchestration and health snapshots
- Used by Akosha for universal storage abstraction and adapter resolution
Installation
uv sync
Commands
Bodai provides a unified CLI for managing the ecosystem:
| Command | Description |
|---|---|
bodai health |
Check health status of all ecosystem components |
bodai start |
Start all ecosystem services |
bodai stop |
Stop all ecosystem services |
bodai restart |
Restart all ecosystem services |
bodai dashboard |
Launch the interactive monitoring dashboard |
bodai shell |
Open an interactive management shell |
bodai config show |
Display current configuration |
bodai config validate |
Validate configuration files |
Architecture
For detailed architecture documentation, see docs/architecture.md.
Development
Running Tests
pytest
Quality Checks
crackerjack run
Related Documentation
- Architecture - System overview and data flow
- Component Roles - Detailed descriptions of each component
- Symbiosis - How components work together
- Port Map - Port allocation and rationale
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bodai-0.1.2.tar.gz.
File metadata
- Download URL: bodai-0.1.2.tar.gz
- Upload date:
- Size: 263.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d081ad2592654282535e3dd783b3942ca0d82c5502b4ee76881d16767a39b614
|
|
| MD5 |
3fdcb8029ed553be508398951bcf35f2
|
|
| BLAKE2b-256 |
fab88287b146db98b5caa2ac2bdb1ed205aed83c95134b6561d01c9d42f9ef57
|
File details
Details for the file bodai-0.1.2-py3-none-any.whl.
File metadata
- Download URL: bodai-0.1.2-py3-none-any.whl
- Upload date:
- Size: 19.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c40c010b5dd4790726c1d21c02e72e345cf7f79aa99f13f3332af9a5f73775a1
|
|
| MD5 |
8bf67e8482c0289960cd472bfcffebf6
|
|
| BLAKE2b-256 |
5c81d5f4ee0ceb5f544df4254e08682a0a4dec2c187bd2318e4988372f496d93
|
