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: 5324/5324 | 77% 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

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

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, multi-agent Crew in ten lines → Agent API
Durable execution & time-travel Checkpoint/resume, replayable tool steps, state history, fork/rewind → Orchestration
Structured event streaming Per-run agent events in-process or over SSE → Orchestration
Cognitive layer MCTS, Tree-of-Thoughts, world model, swarm auctions & handoffs → Reasoning · Swarm
Governance & safety Autonomy gating, durable human-in-the-loop, loop budgets, guardrails, sandboxed code → Autonomy & Safety
Memory & RAG STM→MTM→LTM hierarchy, hybrid search, full RAG pipeline, Qdrant or pgvector backends → Memory · Services
Interoperability Native dual-era MCP (server + client), A2A peer interop → MCP · A2A
Evaluation & observability Trajectory eval in CI, 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.27.0.tar.gz (1.5 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.27.0-py3-none-any.whl (2.0 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: baselith_core-0.27.0.tar.gz
  • Upload date:
  • Size: 1.5 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.27.0.tar.gz
Algorithm Hash digest
SHA256 8754904bb4b628d9b9362311772ed284ff9f7f96bba7d0cc6fca686d95220589
MD5 1f94c8c554b4d63f15386c2b1a38db47
BLAKE2b-256 977ab6a022a790e1ad6373921d1d40a9439a3bbbc61104957961a30da4479666

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: baselith_core-0.27.0-py3-none-any.whl
  • Upload date:
  • Size: 2.0 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.27.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c324358eef5f5486ef4a315e6d2af15c5951e2e213c4bc1883e2addebecb9586
MD5 aa2a5477b35bf2fb87186198db0150b3
BLAKE2b-256 403aca3fdb3a729c7dab65d11856aca6a4d2509b43647bf79ac9181feb150fbe

See more details on using hashes here.

Provenance

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

0.28.0

2 files

This release

0.27.0 This release

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