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.
Etymology: From Sanskrit bodhi (awakening, enlightenment) - the state of supreme understanding.
Ecosystem Components
The Bodai ecosystem consists of six interconnected components, each with a distinct role. Five are network services with MCP servers, while Oneiric serves as a shared library.
| Component | Role | Port | GitHub | Description |
|---|---|---|---|---|
| Mahavishnu | Orchestrator | 8680 | lesleslie/mahavishnu | Multi-engine workflow orchestration |
| Akosha | Seer | 8682 | lesleslie/akosha | Cross-system intelligence & vector embeddings |
| Dhruva | Curator | 8683 | lesleslie/dhruva | 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 |
| Oneiric | Resolver | N/A | lesleslie/oneiric | Conflict resolution library |
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 Dhruva 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 Dhruva
- Provides intelligence to Mahavishnu
- Receives code analysis from Crackerjack
Dhruva - The Curator
From Sanskrit dhruva (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 Dhruva
- 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 Dhruva
- Records metrics in Session-Buddy
Oneiric - The Resolver
From Greek oneiros (dream) - relating to dreams, the abstract and complex
A shared library (no MCP server) that provides conflict resolution algorithms, dependency graph analysis, version conflict detection, and merge strategies. Embedded directly by other components.
- Used by Mahavishnu for workflow conflict resolution
- Used by Dhruva for data merge operations
- Used by Session-Buddy for context merging
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.1.tar.gz.
File metadata
- Download URL: bodai-0.1.1.tar.gz
- Upload date:
- Size: 241.5 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 |
ee172d51647c0e1b3bf7a27921ddce9631090e19b156779419860b7db7955453
|
|
| MD5 |
d6eca5646ee440a27b2e0266dcb95412
|
|
| BLAKE2b-256 |
e60b8cb2507442d6dd4d0b89c60cbe3abbe39bcd944542147f7dc38232d9dc26
|
File details
Details for the file bodai-0.1.1-py3-none-any.whl.
File metadata
- Download URL: bodai-0.1.1-py3-none-any.whl
- Upload date:
- Size: 13.4 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 |
a3c800e1f78bfa92d3d49a56fce4b051361522d051a704f4870b1b8be3a4d26a
|
|
| MD5 |
732a14f7a49f39c6299055fbd3ab9669
|
|
| BLAKE2b-256 |
35a83f3b472f27269b642e3d0d736da41e6b6b4ced840925e46d8036513b8592
|
