Zing Forum

Reading

Keelson: A Modular Framework for Local AI Agents and Deterministic Workflow Engine

Keelson is a locally-run AI agent framework that supports multiple providers (Copilot and Claude), a pluggable Rib extension architecture, and a YAML-based deterministic workflow engine, allowing users to fully control their AI toolchain.

AI代理本地优先多提供商GitHub CopilotClaudeYAML工作流模块化架构开源工具开发者工具隐私保护
Published 2026-06-06 08:45Recent activity 2026-06-06 08:50Estimated read 6 min
Keelson: A Modular Framework for Local AI Agents and Deterministic Workflow Engine
1

Section 01

Keelson: Core Guide to the Local AI Agent Framework

Keelson is a locally-run AI agent framework that supports multiple providers (GitHub Copilot, Claude), a pluggable Rib extension architecture, and a YAML-based deterministic workflow engine, allowing users to fully control their AI toolchain. The project is open-source (Apache 2.0 license), currently in the Alpha stage, maintained by Daniel Scholl, and its source code is hosted on GitHub.

2

Section 02

Background: The Origin of Demand for Local AI Agent Frameworks

With the popularity of AI coding assistants like GitHub Copilot and Claude, existing solutions have issues such as being tied to specific cloud services or lacking scalability. Keelson emerged as a response, with its core philosophy being 'Your machine, your rules'—it runs on local laptops, directly calls local CLI without going through hosted services, and supports on-demand expansion via a modular architecture.

3

Section 03

Core Concepts: Architectural Metaphor and Basic Framework

The name Keelson comes from a nautical term (a longitudinal beam above the keel), metaphorically representing its role as a foundational framework: the Keelson core provides multi-provider support, persistent state, workflow engine, and browser interface; Ribs (as in ship's ribs) are attached functional modules that communicate with the core via standardized interfaces to integrate specific functions.

4

Section 04

Multi-Provider Support: Avoiding Vendor Lock-In

Keelson supports the GitHub Copilot SDK and Claude Agent SDK, and is designed to easily add more providers. It abstracts differences between various SDKs through a unified IAgentProvider interface, allowing upper-layer applications to seamlessly switch underlying providers to adapt to changes in the AI service market (new models, price adjustments, etc.), enhancing flexibility and risk resistance.

5

Section 05

Rib Architecture: A Pluggable Function Extension System

A Rib is an independent npm package (following the naming convention @keelson/rib-<name>) that implements the Rib interface to integrate with the core. During startup, it automatically scans the node_modules/@keelson/ directory to discover Ribs, which can be filtered and activated via environment variables. Advantages: separation of concerns (lean core), composability (install on demand), maintainability (independent development and version control).

6

Section 06

Deterministic YAML Workflow: Repeatable and Auditable Operation Sequences

Keelson uses YAML to define deterministic workflows, which are human-readable, version-controllable, and auditable. Supported node types include prompt (AI prompt), bash (execute command), loop (loop), approval (manual approval), etc. Dependencies between nodes are defined via depends_on, and data is passed using $nodeId.output. Drawing on the Archon project, it is TypeScript-typed and adapted to the Bun+SQLite stack, suitable for repeatable and compliant scenarios.

7

Section 07

Local-First: Data Sovereignty and Privacy Protection

Keelson follows the local-first principle: state is stored in a local SQLite database, credentials are saved in the system keychain via keytar, and workflows are executed locally. The browser interface only accepts local connections (http://127.0.0.1:5173), and sensitive data never leaves the machine, making it suitable for scenarios involving confidential code, proprietary algorithms, or regulated data.

8

Section 08

Use Cases and Project Summary

Applicable Scenarios: Multi-provider strategy (flexible switching), sensitive data processing (local execution), auditable workflows (deterministic), custom tool integration (Rib extension), technical exploration (hackable codebase).

Summary: Keelson returns to the essence of tools, with simplicity, locality, and controllability at its core. Through modular and deterministic design, it provides developers with the option to control their AI toolchain, making it attractive in the era of data sovereignty. The project's tech stack includes Bun, React19, TypeScript, and SQLite, and it is currently in the Alpha stage.