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.
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
- Sacred Core: The
core/directory contains exclusively agnostic logic — orchestration, infrastructure, utilities. No domain code, ever. - Plugin-First: All business logic, integrations, and specialized capabilities live in Plugins, so secondary features never bloat the engine.
- 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8754904bb4b628d9b9362311772ed284ff9f7f96bba7d0cc6fca686d95220589
|
|
| MD5 |
1f94c8c554b4d63f15386c2b1a38db47
|
|
| BLAKE2b-256 |
977ab6a022a790e1ad6373921d1d40a9439a3bbbc61104957961a30da4479666
|
Provenance
The following attestation bundles were made for baselith_core-0.27.0.tar.gz:
Publisher:
ci.yml on baselithcore/baselithcore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
baselith_core-0.27.0.tar.gz -
Subject digest:
8754904bb4b628d9b9362311772ed284ff9f7f96bba7d0cc6fca686d95220589 - Sigstore transparency entry: 2624152322
- Sigstore integration time:
-
Permalink:
baselithcore/baselithcore@1141b0f62b7dd007c0e08a20db4bffa035066b7c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/baselithcore
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@1141b0f62b7dd007c0e08a20db4bffa035066b7c -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c324358eef5f5486ef4a315e6d2af15c5951e2e213c4bc1883e2addebecb9586
|
|
| MD5 |
aa2a5477b35bf2fb87186198db0150b3
|
|
| BLAKE2b-256 |
403aca3fdb3a729c7dab65d11856aca6a4d2509b43647bf79ac9181feb150fbe
|
Provenance
The following attestation bundles were made for baselith_core-0.27.0-py3-none-any.whl:
Publisher:
ci.yml on baselithcore/baselithcore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
baselith_core-0.27.0-py3-none-any.whl -
Subject digest:
c324358eef5f5486ef4a315e6d2af15c5951e2e213c4bc1883e2addebecb9586 - Sigstore transparency entry: 2624152387
- Sigstore integration time:
-
Permalink:
baselithcore/baselithcore@1141b0f62b7dd007c0e08a20db4bffa035066b7c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/baselithcore
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@1141b0f62b7dd007c0e08a20db4bffa035066b7c -
Trigger Event:
push
-
Statement type: