ktx

让 AI 智能体带着公司上下文，准确查数不再瞎猜

ktx 是一个为数据和智能体设计的可执行上下文层，旨在解决 AI 智能体（如 Claude Code、Codex 等）在查询分析型数据库时缺乏业务上下文、准确率低的问题。它通过将公司内部的指标定义、数据模型、业务逻辑等元数据转化为智能体可执行的上下文，使得 AI 能更准确地理解和查询数据。核心能力包括：提供语义层以统一指标口径、自动生成查询代码、支持多种分析数据库、与主流 AI 编程工具无缝集成。ktx 帮助团队将数据知识沉淀为代码，让智能体在分析数据时拥有完整的公司上下文，从而提升数据分析的效率和准确性。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1601

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队Kaelio

所属国家

官网地址https://docs.kaelio.com/ktx

GitHubhttps://github.com/Kaelio/ktx

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent,agent-skills,agents,ai-agent,ai-agents,analytics,analytics-engineering,business-intelligence,claude,claude-code,claude-skills,codex,context-layer,data-analysis,data-engineering,llm,mcp,memory,semantic-layer,skills

GitHub 星标★ 1601

30天Star增速

HF 下载量

上线时间2026-05-10 00:00:00

最近更新2026-09-21 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 8 分钟部署方式：命令行工具 5 步

环境要求

Node.js 与 npm（需支持全局安装 npm 包）
可访问 npm registry 的网络环境
用于存放 ktx 项目的本地目录（如 /home/user/analytics）
可选：已安装 Claude Code、Codex、Cursor、OpenCode 等智能体客户端

安装与启动步骤

1全局安装 ktx

通过 npm 全局安装 @kaelio/ktx，安装完成后终端即可直接使用 ktx 命令。
```
npm install -g @kaelio/ktx
```
2运行初始化向导

执行 ktx setup，创建或恢复本地 ktx 项目，配置 provider 与连接，构建上下文并安装智能体集成。
```
ktx setup
```
3检查就绪状态

运行 ktx status，查看项目、LLM、嵌入模型、数据库、上下文源和智能体集成是否都已就绪。
```
ktx status
```
4按提示启动 MCP

若 status 输出 ktx mcp start --project-dir ...，必须在打开智能体客户端之前先运行它。
```
ktx mcp start --project-dir /home/user/analytics
```
5skill 方式安装

已在用 Claude Code、Codex、Cursor、OpenCode 时，在项目目录让智能体用该命令以 ktx skill 完成安装配置。
```
npx skills add Kaelio/ktx --skill ktx
```

如何确认成功

运行 ktx status，输出中 Project ready、LLM ready、Embeddings ready、Databases configured、Context sources configured、ktx context b

常见问题

Q：ktx status 提示要运行 ktx mcp start 怎么办？

A：按提示中的 ktx mcp start --project-dir ... 命令执行一次，再打开 Claude Code、Codex 等智能体客户端，否则智能体无法读取上下文。

Q：已经装了 Claude Code 或 Codex，还要手动敲命令吗？

A：可以不用。在项目目录里让智能体执行 npx skills add Kaelio/ktx --skill ktx，并使用 ktx skill 自动完成安装与配置。

Q：setup 过程中断可以继续吗？

A：可以。ktx setup 会创建或恢复本地 ktx 项目，重新运行就能接着完成 provider、连接和上下文的配置。

Q：setup 会让我配哪些东西？

A：主要包括 provider（LLM 与 Embeddings）、数据库连接和上下文来源，配置完成后由 ktx status 逐项检查是否就绪。

注意事项

没有安装 Node.js 与 npm 时无法执行 npm install -g，请先准备好 Node 环境。
ktx status 打印出的 ktx mcp start 命令必须在打开智能体客户端之前运行。
README 未给出 Node 版本、端口、配置文件路径等细节，具体以官方文档 https://docs.kaelio.com/ktx 为准。

核心亮点

将指标定义和业务逻辑代码化，形成可执行的语义层，确保 AI 查询口径一致
与 Claude Code、Codex 等主流 AI 编程工具深度集成，开箱即用
支持多种分析数据库，适配现有数据栈，降低接入成本

不足之处

项目较新，生态和文档尚在完善中
依赖 AI 智能体的能力，复杂查询可能仍需要人工干预

适用场景

数据团队为 AI 智能体提供统一的数据查询上下文
业务分析师通过自然语言让 AI 智能体查询公司经营数据
在数据平台中嵌入智能体助手，提供带业务语义的数据问答

替代项目

Cube、dbt Semantic Layer、Lightdash

项目介绍

ktx 是智能体领域的开源项目，由 Kaelio 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,601）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,538 增加到 1,601，净增 63。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-21。

它主要面向的使用场景是：数据团队为AI智能体提供统一的数据查询上下文。同类可对比的替代方案包括 Cube、dbt Semantic Layer、Lightdash。

上一篇：Hermes-CN-Desktop

下一篇：paperdebugger

ktx