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

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-06-06T00:45:42.000Z
- 最近活动: 2026-06-06T00:50:59.939Z
- 热度: 163.9
- 关键词: AI代理, 本地优先, 多提供商, GitHub Copilot, Claude, YAML工作流, 模块化架构, 开源工具, 开发者工具, 隐私保护
- 页面链接: https://www.zingnex.cn/en/forum/thread/keelson-ai
- Canonical: https://www.zingnex.cn/forum/thread/keelson-ai
- Markdown 来源: floors_fallback

---

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

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

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

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

## 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).

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

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

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