5分钟从0到1：用这个开源报表工具，让AI帮你做Excel报表

随享科技
0 阅读4分钟

ai-light-report 是一个基于大语言模型（LLM）的轻量级开源报表系统，支持通过自然语言交互自动理解数据库语义并生成 SQL，快速产出可视化的报表。本文将手把手带你从零开始，搭建并体验这个报表工具。

Github 开源仓库：github.com/isuixiang/a…

ui-login.png

第一步：环境准备与项目安装

在开始之前，请确认本地已安装：

  • Python 3.9 及以上（推荐 3.9 或 3.10）
  • MySQL 5.7 及以上

首先，将项目克隆到本地：

git clone https://github.com/isuixiang/ai-light-report.git
cd ai-light-report

为了隔离环境，建议创建并激活虚拟环境：

# Windows
python -m venv venv
venv\Scripts\activate
​
# Mac/Linux
python3 -m venv venv
source venv/bin/activate

接着安装依赖包：

pip install -r requirements.txt

第二步：数据库初始化与配置

ai-light-report 需要两个数据库：项目数据库（存放数据源、报表模板等数据）和演示数据库（存放样例业务数据，方便上手测试）。

在 MySQL 中执行以下命令创建数据库并导入初始化脚本：

# 创建项目数据库
mysql -u root -p -e "CREATE DATABASE ailightreport;"
mysql -u root -p ailightreport < data/db/ailightreport.sql
​
# 创建演示数据库（可选，但强烈推荐）
mysql -u root -p -e "CREATE DATABASE demo;"
mysql -u root -p demo < data/db/dataanalysis.sql

接下来配置连接信息。复制示例配置文件：

cp example.env .env

编辑 .env 文件，填入正确的数据库连接信息：

DB_HOST = "127.0.0.1"
DB_PORT = 3306
DB_NAME = "ailightreport"
DB_USER = "root"
DB_PASSWORD = "你的数据库密码"
# 如果使用了演示数据库，后续在界面中配置数据源时会用到

第三步：启动服务与登录

一切就绪后，启动 Flask 应用：

flask run

启动成功后，打开浏览器访问：http://127.0.0.1:5000

系统默认的登录账户是：

  • 用户名：admin
  • 密码：123456

登录后，你会看到主控台界面。

ui-home.png

第四步：连接数据源与大模型

要让系统“听懂”你的问题，需要先告诉它数据在哪里，并给它装上“大脑”。

1. 创建数据源 在左侧菜单栏找到“数据源管理”，点击“新增”。选择数据库类型（MySQL 或 SQLServer），填入演示数据库的连接信息。这里以第二步中导入的 demo 数据库为例。

ui-datasource.png

2. 配置大模型 API 进入“模型管理”，点击“添加模型”。ai-light-report 已集成 DeepSeek、Kimi、Qwen 等主流大模型。这里以 DeepSeek 为例：

  • 选择模型类型：DeepSeek
  • 填入 API Key（可从 DeepSeek 官网免费申请）
  • 保存配置并设为默认

ui-llms.png

3. 添加“技能”（可选） “技能”是指系统如何理解业务术语。项目根目录下的 data/skills 目录已经预制了一些示例技能文件，可以直接使用。后续也可以根据业务需要自定义。

ui-skills.png

第五步：用自然语言生成第一张报表

现在，让我们用自然语言生成第一张报表。

1. 准备 Excel 模板 ai-light-report 支持导入现有的 Excel 报表模板，可以是包含合并单元格、计算公式的复杂样式。在“报表模板”管理中，点击“上传模板”，选择项目目录 data/excels 下的示例文件。

2. 开始智能生成 上传成功后，点击“使用此模板”。在聊天对话框中输入你的需求，例如：

  • “查询工资发放记录”

系统会自动将你的自然语言翻译成 SQL，查询数据库，并按照模板格式填充数据，最终生成一张完整的报表。

从提问到看到最终结果，整个过程通常只需要几分钟。

ui-chat.png

至此，我们已经成功安装并运行了 ai-light-report，并且生成了第一张智能报表。整个过程无需编写一行 SQL 代码，真正实现了“所说即所得”。

ai-light-report 还支持：

  • 一键生成逻辑：自动识别报表模板的数据特征，无需手动配置报表与数据字段的映射关系；
  • 自定义二次编辑：生成的报表逻辑可以手动调整，满足个性化的业务需求。

如果你在体验过程中遇到问题，可以通过项目主页的 GitHub Issues 或联系维护者获取帮助。

avatar
文章
阅读
粉丝