Skip to main content

BaselithCore Logo

BaselithCore

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

Python 3.12+ License: AGPL v3 Code Style: Ruff Checked with mypy Tests: 6321/6321 | 79% PyPI version

EU AI Act toolkit World Model: MCTS Swarm Intelligence 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.


Why BaselithCore

  • Agents that survive production. Durable execution with checkpoint/resume, replayable tool steps, state history and fork/rewind — a crash mid-run recovers without duplicating a single side effect.
  • Everything included, nothing rented. Evaluation suites, LLM-as-judge, red-teaming, OpenTelemetry tracing, Prometheus metrics with real USD cost, Helm/Terraform deployment — built in and self-hosted, with no companion SaaS to subscribe to.
  • Brakes, not just horsepower. Autonomy gating, durable human-in-the-loop approvals, per-request cost budgets, prompt-injection guardrails, sandboxed code execution — every seam fail-closed by default, plus opt-in EU AI Act / GDPR compliance primitives.

Ten lines to a working multi-agent pipeline — typed, budgeted, observable:

from core.agent import Agent, Crew, Task

researcher = Agent(system_prompt="You are a meticulous researcher.")
writer = Agent(system_prompt="You write crisp executive summaries.")

crew = Crew(agents=[researcher, writer], tasks=[
    Task("Research {topic} and list the key facts.", agent=researcher),
    Task("Write a summary from the research.", agent=writer),
])
report = (await crew.run(inputs={"topic": "vector databases"})).final

Architecture at a Glance

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

        LP["Engineered Loops<br/>(verifier · stall guard · escalation)"]
        M["Memory Hierarchy<br/>(STM → MTM → LTM)"]
        S["Storage Layer<br/>(Postgres · Qdrant/pgvector · Redis)"]
        R["Plugin Registry"]
        RES["Resilience · Observability · Guardrails"]
    end

    A --> COG
    A --> F
    A --> LP
    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 · AP2 mandates · realtime duplex)"]
    A -.->|wrapped by| RES

The full deep-dive lives in the architecture docs.

Core Philosophy

  1. Sacred Core: The core/ directory contains exclusively agnostic logic — orchestration, infrastructure, utilities. No domain code, ever.
  2. Plugin-First: All business logic, integrations, and specialized capabilities live in Plugins, so secondary features never bloat the engine.
  3. Agentic by Design: The Agentic Design Patterns (Memory, Reflection, Tool Use, Planning, …) are baked into the orchestrator, not bolted on.

What's Inside

Every capability ships production-hardened: typed, tested, observable, and fail-closed by default.

Typed agents & declarative crews Single-import Agent, sequential/parallel/manager-led Crew, free-form group chat → Agent API
Durable execution & time-travel Checkpoint/resume (Postgres, SQLite or in-memory), replayable tool steps, state history, fork/rewind → Orchestration
Loop engineering Verifier-owned loops with stall detection, feed-forward lessons, escalation and resumable outcomes → Loops
Structured event streaming Per-run agent events in-process or over SSE, plus async run submission with completion webhooks → Orchestration
Cognitive layer MCTS, Tree-of-Thoughts, world model, swarm auctions & bounded handoffs → Reasoning · Swarm
Governance & safety Autonomy gating, durable human-in-the-loop, plan approval, loop & tool budgets, layered guardrails, sandboxed code → Autonomy & Safety
Memory & RAG STM→MTM→LTM hierarchy, hybrid search, hierarchical chunking, full RAG pipeline, Qdrant or pgvector backends → Memory · Services
Multimodal Vision, native PDF and audio content blocks, duplex realtime voice with barge-in → Services · Realtime
Interoperability Native dual-era MCP (server + client + declarative registry), A2A peer interop, AP2 signed-mandate commerce → MCP · A2A · World Model
Self-improvement, governed Skill evolution, prompt compilation and evolutionary search — every change eval-gated, audited and human-approvable → Skill Evolution · Optimization
Evaluation & observability Trajectory eval in CI, multi-model bake-off, LLM-as-judge, red-team, OTel + Prometheus with USD cost metrics → Evaluation
Regulatory toolkit Opt-in EU AI Act / GDPR / NIS2 / DORA primitives with evidence trails → Regulatory Compliance
Production deployment Docker, Helm, Terraform, SLO rules, typed SDKs → Deployment

Quick Start

pip install baselith-core       # core engine
docker compose up -d            # Redis, PostgreSQL, Qdrant (optional)
baselith doctor                 # validate environment and configuration

Optional capabilities (RAG, browser automation, OCR, extra model providers, vector backends, …) install as extras — see the installation guide for the full list, and the quickstart to build your first agent.

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.
Regulatory Compliance AI Act, GDPR, NIS2 and DORA mapped article by article — gaps included.
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.

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.28.0.tar.gz (1.7 MB 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.28.0-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file baselith_core-0.28.0.tar.gz.

File metadata

  • Download URL: baselith_core-0.28.0.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for baselith_core-0.28.0.tar.gz
Algorithm Hash digest
SHA256 1a915b61bf59721ae2eb7ec19124c9299f2ad38babbc0104487acaae23953c71
MD5 588cc4c547220f74d4be5e3612702d2e
BLAKE2b-256 dc3680ad4b11d201a033df7a982ff165ec350f176c829c53312873a5d878bd88

See more details on using hashes here.

Provenance

The following attestation bundles were made for baselith_core-0.28.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.28.0-py3-none-any.whl.

File metadata

  • Download URL: baselith_core-0.28.0-py3-none-any.whl
  • Upload date:
  • Size: 2.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for baselith_core-0.28.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3ff970c15eb76c0fea284888fcf0b6f8c24f304a664fa48962af8e382f37c199
MD5 7573f74f0886738d8c4ebd0a392e959d
BLAKE2b-256 ed07257f5b0662f33fd524de0a3e330fa6625da2c327d9e1c13c88d4539c4724

See more details on using hashes here.

Provenance

The following attestation bundles were made for baselith_core-0.28.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.

Release history Release notifications | RSS feed

0.31.1

2 files

0.31.0

2 files

0.30.0

2 files

0.29.0

2 files

This release

0.28.0 This release

2 files

0.27.0

2 files

0.25.0

2 files

0.24.0

2 files

0.23.0

2 files

0.22.0

2 files

0.21.0

2 files

0.20.0

2 files

0.19.0

2 files

0.18.0

2 files

0.16.0

2 files

0.15.0

2 files

0.14.0

2 files

0.13.0

2 files

0.12.0

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page