Deterministic first
Known signatures and project-owned rules run before optional model reasoning.
OPEN SOURCEAPACHE-2.0PYTHON 3.11+
Agentic self-healing for data & AI pipelines.
Lumis SDK is an open-source, vendor-agnostic Python framework for deterministic diagnosis and guarded recovery across data, ML, and software-delivery pipelines— deterministic first, evidence grounded, model optional, and under explicit human and policy control.
$ uv add lumis-sdkFIG. 01 / GUARDED RECOVERY FRAMEWORKLOCAL READY
INCIDENT CONTEXT
logs · metrics · lineage · schema · code01TRIAGEdeterministic
02DIAGNOSEevidence + memory
03PLANrecommendation
04APPROVEpolicy boundary
DETERMINISTIC PATHKnown signatures remain explainable and reproducible.current foundation
OPTIONAL MODEL PATHUnknown cases may route through a bounded gateway.explicit opt-in
VERIFYexplicit result
LEARNmemory + rule candidates
NO CORE ACTION EXECUTORNO REQUIRED CLOUDNO REQUIRED MODELNO DEFAULT TELEMETRYNO UNRESTRICTED ACTUATION
A SMALL CORE / EXPLICIT BOUNDARIES
Framework primitives.
Your operating stack.
Lumis SDK supplies reusable semantics and safety controls while teams keep their monitoring, storage, model, workflow, and deployment choices.
Evidence grounded
Facts, evidence, hypotheses, contradictions, confidence, and gaps stay distinct.
Model optional
The core runs offline. Providers implement a narrow, explicitly enabled gateway.
Local first
SQLite and Markdown provide inspectable defaults without a hosted dependency.
Vendor agnostic
Core contracts remain independent of observability, cloud, orchestration, and agent vendors.
Guarded by design
Plans, approvals, verification, audit, and truth state remain explicit boundaries.
PORTS & ADAPTERS
Compose recovery without vendor lock-in.
A strict domain holds incident and recovery meaning. Application services coordinate it through replaceable ports; local reference adapters—and independent plugins—connect the infrastructure you choose.
PROJECT ENTRY POINTS
Lumis SDK CLIinit · doctor · diagnose · rules · plugins
→Python applicationdiagnosis · evidence · lifecycle
→Strict configurationlumis.dev/v1 · checked schemas
→VENDOR-NEUTRAL CORE
Application servicesdiagnose · propose · verify · learn
→Domain contractsevidence · plans · approvals · truth
→Provider portsmodel · memory · policy · audit
→REFERENCE ADAPTERS
Deterministic ruleslegacy text + structured engine
→Evidence & redactionbounded local JSON · conservative
→Reports & memoryMarkdown · JSON · SQLite
→Plugin catalogpostgres memory · HTTP evidence
→Domain and application packages import no observability, orchestration, cloud, model-provider, or agent SDK. Independent plugins attach through ports—discovery never grants authority.
THE PAPER / SEVEN LOGICAL LAYERS
Verified repetition becomes policy.
Telemetry and incident memory ground deterministic policy and bounded agentic reasoning. Approved actions pass through guarded execution; verification then closes two learning loops.
- 01Pipeline estate
- 02Telemetry + signals
- 03Incident memory
- 04Policy + reasoning
- 05Approval + governance
- 06Guarded execution
- 07Verification + learning
VERIFIED EPISODESsame pattern × NExample policy: 5 confirmed recurrences
→PROMOTION GATEreview + replay testsThreshold is project-configurable
→DETERMINISTIC POLICYversioned ruleKnown incidents take the cheaper path
Lumis SDK begins with reproducible diagnosis and ships typed contracts for planning, approval, verification, audit, and learning. Execution is intentionally absent from core.
DIAGNOSIS TODAY / HEALING OVER TIME
A lifecycle designed for guarded autonomy.
01Detectexternal / local input
02Triagedeterministic classification
03Diagnoserules + optional model
04Planplaybook proposals
05Approveidempotent decisions
06Remediatefuture RFC-gated work
07Verifyexplicit truth records
08Learnmemory + rule candidates
IMPLEMENTATION BOUNDARYBlue stages ship today as code or typed contracts. Amber remediation remains future, RFC-governed work requiring allowlists, policy, approval, audit, limits, idempotency, and verification.
THE OPEN FOUNDATION
Small enough to understand. Open enough to extend.
Lumis SDK is the reusable framework layer—not a monitoring system, orchestrator, hosted control plane, or mandatory agent runtime.
OPEN SOURCE / PLATFORM COMING SOON
Lumis SDK stays useful on its own.
Use the framework locally or self-host it today. The managed Lumis platform by Qadim Labs is still in development.
LUMIS SDK
- Open-source framework
- Local and self-hosted
- Community adapters
- Your infrastructure and policies
LUMIS · COMING SOON
- Hosted team workflows
- Managed integrations and memory
- Approvals, audit, and runners
- Enterprise deployment and support
FROM RESEARCH TO FRAMEWORK
Born in a paper.
Built in the open.
Lumis SDK implements the agentic recovery and incident response reference architecture proposed in research led by Solomon Eshun, the project's maintainer—together with the open-source contributors who join in.
RESEARCH PAPERPUBLISHED ON arXiv · 2608.01955
Agentic Self-Healing for Data & AI Pipelines: An Affordable Vendor-Agnostic Architecture using Open-Source Software
The paper proposes a seven-layer, vendor-agnostic architecture for guarded self-healing. Verified outcomes enrich incident memory, while recurring diagnosis-and-remediation patterns can be reviewed, tested, and promoted into deterministic rules—making repeated incidents cheaper and more predictable.
VIDEO · COMING SOONIntro to Lumis SDK — your first deterministic diagnosis
Walking the simple-log-diagnosis cookbook from install to a confirmed resolution.
13 RUNNABLE COOKBOOKSPrefer reading? Every cookbook is a self-contained walkthrough.Synthetic, offline, and reproducible—from first diagnosis to guarded proposals.
Lumis SDK is developed in the open under Apache-2.0. Every rule engine, contract, and safety boundary is reviewable—and shaped by the people who show up.
BUILT IN PUBLIC
Open source,
from the first commit.
Star history starts here.
Great infrastructure tools are transparent, inspectable, and owned by their community. Read the source, run it offline, self-host it—you are never locked in.
CONTRIBUTORS
GITHUBIssues, RFCs, and discussionsOPEN ↗
X / TWITTERBuild-in-public updatesSOON
DISCORDCommunity chat and supportSOON
PRE-ALPHA / CONTRIBUTORS WELCOME
Build the open foundation for trustworthy self-healing systems.
Apache-2.0 licensed, typed, local-first, and built in public.