baselith-core 0.16.0

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

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.

Quick Start | Architecture | Plugin System | API Reference

---

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 SC["Sacred Core (Agnostic Engine)"]
        A["Core Orchestrator<br/>(intent · routing · adaptive loop · durable checkpoint/resume)"]
        F["Flow Handlers"]

        subgraph COG["Cognitive Layer"]
            RE["Reasoning<br/>(MCTS · Tree-of-Thoughts)"]
            WM["World Model<br/>(risk · rollback · simulation)"]
            SW["Swarm<br/>(auction protocols)"]
            PL["Planning"]
            MT["Meta · Reflection · Adversarial"]
        end

        M["Memory Hierarchy<br/>(STM → MTM → LTM)"]
        S["Storage Layer<br/>(Postgres · Qdrant · Redis)"]
        R["Plugin Registry"]
        RES["Resilience · Observability · Guardrails"]
    end

    A --> COG
    A --> F
    A --> M
    M --> S
    COG --> M

    R --> C["Custom Agent Plugins"]
    R --> D["Capability Extensions"]
    R -.->|Inject Handlers| A
    R -.->|Inject Routers| G["API Gateway"]

    A --> H["LLM Layer<br/>(Anthropic · OpenAI · Ollama · HF)<br/>native tool-calling · structured output"]
    F --> H

    A --> I["Interop<br/>(MCP 2025-06-18 · A2A streaming)"]
    A -.->|wrapped by| RES

---

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.
• Native Tool-Calling: Provider-agnostic tool-calling and structured outputs across Anthropic, OpenAI, and Ollama, with a prompt-coercion fallback for providers without a native API.
• Durable Execution: Checkpoint/resume of the agent loop with idempotent, deterministic-replay tool steps (in-memory or Postgres-backed), so a crash mid-run recovers without duplicating side effects.
• Swarm Intelligence: Decentralized Auction Protocols for optimal task allocation, structured agent handoffs, and budget-aware structured concurrency across agent collectives.
• Multilayered Memory: Research-grade memory hierarchy (STM → MTM → LTM) with token-budgeted context assembly and intelligent consolidation.
• Interoperability: Native Model Context Protocol (MCP, 2025-06-18) with tool annotations, and A2A peer interop with SSE streaming.

---

Quick Start

1. Prerequisites

• Python: 3.12+
• 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

Install optional capabilities only when needed:

# RAG / embedding / reranking
pip install "baselith-core[rag]"

# Browser automation and JS rendering
pip install "baselith-core[browser,web]"

# Document ingestion and OCR
pip install "baselith-core[documents,ocr,nlp]"

# Hugging Face provider support
pip install "baselith-core[huggingface]"

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.