A Modular Framework for Baselith-Core Orchestration featuring World Models (MCTS), Swarm, and Native MCP.
Project description
BaselithCore
The Research-Backed Engine for Production-Grade Agentic AI.
BaselithCore is a high-performance orchestration engine designed to transition agentic AI from experimental prototypes to resilient, production-ready infrastructure. Built on a modular architecture, it provides an agnostic foundation for engineering scalable multi-agent systems.
Core Philosophy
BaselithCore is governed by a strict architectural separation:
- Sacred Core: The
core/directory contains exclusively agnostic logic—orchestration, infrastructure, and utilities. It remains untainted by domain-specific logic. - Plugin-First: All business logic, external integrations, and specialized capabilities are implemented as Plugins, ensuring secondary features never bloat the primary engine.
- Agentic by Design: Native adherence to the Agentic Design Patterns (Memory, Reflection, Tool Use, etc.) is baked into the orchestrator.
Architecture Overview
graph TD
subgraph "Sacred Core (Agnostic Engine)"
A["Core Orchestrator"]
M["Memory Hierarchy (STM/MTM/LTM)"]
S["Storage Layer (DB/Vector)"]
R["Plugin Registry"]
end
R --> C["Custom Agent Plugins"]
R --> D["Capability Extensions"]
A --> M
M --> S
A --> F["Flow Handlers"]
R -.->|Inject Handlers| A
R -.->|Inject Routers| G["API Gateway"]
A --> H["LLM Layer (Anthropic, OpenAI, Ollama, HF)"]
F --> H
Key Capabilities
Cognitive Orchestration
We manage the complexity of agentic reasoning so you can focus on domain value.
- Strategic Optimization: Native Monte Carlo Tree Search (MCTS) and Tree of Thoughts for advanced decision-making and "What-If" simulations.
- Swarm Intelligence: Decentralized Auction Protocols for optimal task allocation and resource efficiency across agent collectives.
- Multilayered Memory: Research-grade memory hierarchy (STM → MTM → LTM) with intelligent context consolidation.
- Interoperability: Built with native Model Context Protocol (MCP) support for seamless tool and data integration.
Quick Start
1. Prerequisites
- Python: 3.10+
- Docker: For Redis, Qdrant, and PostgreSQL infrastructure.
- Vector/Relational Storage: Managed via Docker Compose.
2. Installation
Install the core engine via pip:
pip install baselith-core
Or clone for extension development:
git clone https://github.com/baselithcore/baselithcore.git
cd baselith-core
docker compose up -d
3. Verification
baselith doctor # Validate environment and configuration
Resources
| Resource | Description |
|---|---|
| Official Website | The core landing page for the BaselithCore framework. |
| Official Documentation | The official docs for the BaselithCore framework. |
| Architecture | Deep dive into the "Sacred Core" and design choices. |
| Plugin Guide | How to extend BaselithCore using the plugin system. |
| Agentic Patterns | Implementation of Agentic Design Patterns. |
| Deployment | Production-ready deployment strategies. |
Contributing & License
We welcome contributions that adhere to our code standards. Please review CONTRIBUTING.md.
BaselithCore is licensed under the GNU Affero General Public License v3.0 (AGPL v3). See LICENSE for full details.
Copyright © 2026 BaselithCore Team.
Project details
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 baselith_core-0.5.0.tar.gz.
File metadata
- Download URL: baselith_core-0.5.0.tar.gz
- Upload date:
- Size: 606.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cfcb304b80ef12b03b225a42750031954976270e7dd68e1076ececa7ceca112c
|
|
| MD5 |
3a8caf0bb5a21c48a2ab66cc3e60bd54
|
|
| BLAKE2b-256 |
b9dd9b8253670279b4ead2b9c621490a4dcda4f3164759b4ec69987439265eb1
|
Provenance
The following attestation bundles were made for baselith_core-0.5.0.tar.gz:
Publisher:
ci.yml on baselithcore/baselithcore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
baselith_core-0.5.0.tar.gz -
Subject digest:
cfcb304b80ef12b03b225a42750031954976270e7dd68e1076ececa7ceca112c - Sigstore transparency entry: 1235174072
- Sigstore integration time:
-
Permalink:
baselithcore/baselithcore@928baf48895cdd0dd68f664a14e3f5f2186eba8d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/baselithcore
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@928baf48895cdd0dd68f664a14e3f5f2186eba8d -
Trigger Event:
push
-
Statement type:
File details
Details for the file baselith_core-0.5.0-py3-none-any.whl.
File metadata
- Download URL: baselith_core-0.5.0-py3-none-any.whl
- Upload date:
- Size: 817.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d728928e3d954cb05d39f5b233de1addcb5654aa41fa464879e99272c9baef9c
|
|
| MD5 |
3230138eb3657886d2e4528c36085753
|
|
| BLAKE2b-256 |
1992c60cead58a3c46183759eccc5079d31ed0da7a1cb3fe77941294b436eb15
|
Provenance
The following attestation bundles were made for baselith_core-0.5.0-py3-none-any.whl:
Publisher:
ci.yml on baselithcore/baselithcore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
baselith_core-0.5.0-py3-none-any.whl -
Subject digest:
d728928e3d954cb05d39f5b233de1addcb5654aa41fa464879e99272c9baef9c - Sigstore transparency entry: 1235174163
- Sigstore integration time:
-
Permalink:
baselithcore/baselithcore@928baf48895cdd0dd68f664a14e3f5f2186eba8d -
Branch / Tag:
refs/heads/main - Owner: https://github.com/baselithcore
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@928baf48895cdd0dd68f664a14e3f5f2186eba8d -
Trigger Event:
push
-
Statement type: