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:

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 · Gemini · Ollama · HF)<br/>native tool-calling · typed output · cross-provider fallback"]
    F --> H

    A --> I["Interop<br/>(MCP · 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 & Typed Output: Provider-agnostic tool-calling and structured outputs across Anthropic, OpenAI, Gemini and Ollama, with a prompt-coercion fallback for providers without a native API. generate_typed() returns a validated Pydantic instance — schema derived from the model, self-repairing on a schema violation.
• 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 — plus an opt-in startup sweep that resumes runs interrupted by a restart.
• Swarm Intelligence: Decentralized Auction Protocols for optimal task allocation, structured agent handoffs (objective / facts / already-attempted brief, bounded payload), and budget-aware structured concurrency across agent collectives.
• Multilayered Memory: Research-grade memory hierarchy (STM → MTM → LTM) with token-budgeted context assembly, intelligent consolidation, and optional context folding — older turns summarized, recent ones verbatim, instead of hard truncation.
• Composable Workflows: Graph execution with per-node retry/backoff and cyclic evaluation loops (generate → evaluate → refine), bounded by a step budget so a non-converging loop fails instead of hanging.
• Interoperability: Native Model Context Protocol (MCP, 2025-11-25) with tool annotations, and A2A peer interop with SSE streaming and durable task storage.

Governance & Safety

Production agents need brakes, not just capability. Every seam is fail-closed by default.

• Autonomy Gating: A three-tier autonomy policy (supervised → semi → fully autonomous) decides which tool categories need human approval. The gate applies to every execution path — the ReAct loop, the parallel executor, and MCP — never just the easy one.
• Human-in-the-Loop: An approval request durably pauses the run (awaiting_approval) instead of failing it; operators list, approve/deny and resume through the /approvals API, and the loop replays completed steps.
• Loop Budgets: Per-request caps on iterations, tool calls, tokens, wall-clock deadline and USD cost, charged from inside the LLM layer — plus early escalation when a tool fails repeatedly, so a broken dependency can't burn the whole budget.
• Content Guardrails: Input guardrails run before any budget or LLM spend, on the streaming path too; non-streamed responses are filtered for PII and harmful content; external content (MCP results, scraped pages, skill bodies) is scanned and sanitized for indirect prompt injection by default.
• Sandboxed Code Execution: Agent-written code runs in Docker or MicroVM isolation (no network, dropped capabilities, resource caps), preceded by AST static analysis that rejects malformed code and flags dangerous imports before a container even starts.
• Prompt-as-Code: The conversation system prompt ships as a versioned, checksummed file served through a prompt registry — with labels, deterministic A/B bucketing, OTel provenance on every render, and deployment-level overrides via a prompt catalog directory.
• Enforced Quality Gates: A deterministic trajectory-eval suite gates every merge in CI (no API keys, no network), alongside architecture-boundary, strict-typing, file-size, plugin-integrity and OpenAPI-drift gates.

New safety and portability features that change runtime behaviour ship opt-in (extended thinking, context folding, durable checkpointing, crash recovery): defaults preserve existing behaviour, and enabling them is a deployment decision.

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]"

# Additional model providers
pip install "baselith-core[gemini]"
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

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.