imldy/KELA-Agents

AI-powered Excel assistant that lets you query, analyze and visualize data using natural language. No SQL or coding required.

★ 0Forks 0GitHub ↗Compare

README

KELA Agents Logo

KELA Agents

专为大数据量 Excel 设计的智能问答助手
50+ 列、10万+ 行?没问题。用自然语言,快速找到你要的数据。


💡 项目理念

  • 关注核心 - 在海量数据中理清头绪,找到真正需要的信息
  • 关注需求 - 用自然语言描述需求,AI 帮你完成查询
  • 关注数据 - 数据安全存储在本地,按需付费使用 LLM

📸 功能截图

主页 核心业务

数据表 智能导入

📷 查看完整截图


🔬 工作原理

┌─────────────────────────────────────────────────────────────┐
│  1. 导入 Excel                                               │
│     └─ LLM 自动理解表头(支持二级、三级复杂表头)              │
│                        ↓                                     │
│  2. 数据入库                                                 │
│     └─ 转换为 SQLite 数据库,支持高效查询                     │
│                        ↓                                     │
│  3. 自然语言问答                                             │
│     └─ AI 将问题转为 SQL,执行查询、修改、聚合等操作          │
└─────────────────────────────────────────────────────────────┘

✨ 核心功能

功能 说明
🔧 自行配置 LLM 支持 OpenAI、DeepSeek、通义千问等,使用自己的 API Key
📊 数据可视化 8 种图表类型,基于 ECharts
🔗 多表联查 多个 Excel 数据表可关联查询

🛠 AI 工具集

KELA 为大模型提供了丰富的工具:

数据筛选与聚合

  • 可回溯的筛选条件 - 每次筛选都可追溯
  • 可回溯的聚合数据 - 查看 LLM 获取的原始数据

黑板 (Blackboard)

  • 用于总结和展示关键信息给用户

图表生成

支持 8 种图表类型,可保存到本地:

柱状图 折线图 饼图 散点图
Bar Line Pie Scatter
面积图 漏斗图 雷达图 词云
Area Funnel Radar Word Cloud

Excel 导出

4 种导出方式:

  1. 全表导出
  2. 筛选条件导出
  3. LLM 查询结果导出
  4. 自然语言描述 → LLM 聚合生成 Excel

👁 用户视图

用户可以随时查看:

  • 📈 全部历史图表
  • 📋 全部黑板总结
  • 🔍 全部聚合数据查询记录

🎯 使用场景

场景 描述
数据可视化 快速生成各类图表
数据提取 从大表中精准获取业务所需数据
数据清洗 用自然语言描述清洗规则
数据新增 通过对话新增记录
多表查询 跨多个 Excel 进行关联分析

🖱 便捷交互

  • 引用功能 - 减少重复输入提示词
  • 快速隐藏列 - 批量隐藏无关列,聚焦核心数据
  • 可点击的工具结果 - LLM 工具可点击复现过程数据,操作透明可追溯

⚡ 项目优势

优势 说明
大数据性能 50+ 列、10万+ 行数据表可快速查询聚合
天然速度优势 基于数据库原理设计,数据量越大优势越明显
数据安全 所有数据在本地处理,不上传到任何平台
隐私保护 仅向 LLM 发送必要数据,不采集用户业务数据
操作可溯源 所有 LLM 操作的数据均可追溯查看
按需付费 使用自己的 API Key,充多少花多少,软件本身免费

容量支持

限制项 数值
Excel 文件数 最多 3 个
数据列总数 最多 100 列(合计)
数据行数 不限制(取决于电脑内存)

详见 性能说明

⚠️ 项目局限

在决定使用前,请了解以下局限性:

局限 原因
仅支持单 Sheet 多 Sheet 的 Excel 需拆分为多个文件分别导入
无法直接操作 Office 项目原理是将数据导入内部数据库处理
无法对已有数据表追加数据 结构设计限制(LLM 新增记录除外)
无法调整 Excel 样式 项目专注数据分析,不关注样式
操作灵活性不如 Office 这是数据分析工具,不是 Office 替代品
小数据量不推荐使用 几十行数据直接用 Excel 更方便
预处理时间较长 需要 LLM 理解表头结构
预处理消耗 Token 详见 Token 消耗说明

🌍 多语言支持

语言 Language 状态
简体中文 Chinese (Simplified) ✅
English English ✅
日本語 Japanese ✅
한국어 Korean ✅
Français French ✅
Deutsch German ✅
Русский Russian ✅

📖 开源计划

本项目计划开源,目前仍在积极开发中,待功能稳定后将公开源代码。

当前状态:开发中,暂未开源

欢迎 Star ⭐ 本仓库,关注项目进展!

📥 下载安装

从 Releases 页面下载:

平台 文件
Windows KELA-Agents-x.x.x-Setup.exe
macOS (Intel) KELA-Agents-x.x.x-x64.dmg
macOS (Apple Silicon) KELA-Agents-x.x.x-arm64.dmg
项目 大小
安装包 ~170 MB
安装后占用 ~660 MB

🤝 贡献与反馈

📄 许可证

MIT License

📮 联系

Issues