Skip to main content

A Modular Framework for Baselith-Core Orchestration featuring World Models (MCTS), Swarm, and Native MCP.

Project description

BaselithCore Logo

BaselithCore

The Research-Backed Engine for Production-Grade Agentic AI.

Python 3.10+ License: AGPL v3 Code Style: Ruff Checked with mypy Tests: 1804/1804 | 69% PyPI version

World Model: MCTS Swarm Intelligence Agentic Patterns Native MCP Docker Ready


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:

  1. Sacred Core: The core/ directory contains exclusively agnostic logic—orchestration, infrastructure, and utilities. It remains untainted by domain-specific logic.
  2. Plugin-First: All business logic, external integrations, and specialized capabilities are implemented as Plugins, ensuring secondary features never bloat the primary engine.
  3. 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

baselith_core-0.5.0.tar.gz (606.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

baselith_core-0.5.0-py3-none-any.whl (817.0 kB view details)

Uploaded Python 3

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

Hashes for baselith_core-0.5.0.tar.gz
Algorithm Hash digest
SHA256 cfcb304b80ef12b03b225a42750031954976270e7dd68e1076ececa7ceca112c
MD5 3a8caf0bb5a21c48a2ab66cc3e60bd54
BLAKE2b-256 b9dd9b8253670279b4ead2b9c621490a4dcda4f3164759b4ec69987439265eb1

See more details on using hashes here.

Provenance

The following attestation bundles were made for baselith_core-0.5.0.tar.gz:

Publisher: ci.yml on baselithcore/baselithcore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for baselith_core-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d728928e3d954cb05d39f5b233de1addcb5654aa41fa464879e99272c9baef9c
MD5 3230138eb3657886d2e4528c36085753
BLAKE2b-256 1992c60cead58a3c46183759eccc5079d31ed0da7a1cb3fe77941294b436eb15

See more details on using hashes here.

Provenance

The following attestation bundles were made for baselith_core-0.5.0-py3-none-any.whl:

Publisher: ci.yml on baselithcore/baselithcore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page