智能数据分析助手
经 AI Skill Hub 精选评估，智能数据分析助手 获评「强烈推荐」。已获得 2.0k 颗 GitHub Star，这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 8.8 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
智能数据分析助手 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 智能数据分析助手 的版本更新，及时通知重要功能变化。
📋 工具概览
一个由大模型驱动的开源数据分析工作流，支持通过自然语言对话自动生成可视化报表与商业洞察。它将复杂的数据处理流程简化为聊天交互，非常适合数据分析师、业务运营人员及需要快速获取数据结论的决策者。
智能数据分析助手 是一款基于 Python 开发的开源工具，专注于 数据分析、自动化报表、商业智能 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
一个由大模型驱动的开源数据分析工作流，支持通过自然语言对话自动生成可视化报表与商业洞察。它将复杂的数据处理流程简化为聊天交互，非常适合数据分析师、业务运营人员及需要快速获取数据结论的决策者。
智能数据分析助手 是一款基于 Python 开发的开源工具，专注于 数据分析、自动化报表、商业智能 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：pip 安装（推荐）
pip install data-analysis-agent
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install data-analysis-agent
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/Zafer-Liu/Data-Analysis-Agent
cd Data-Analysis-Agent
pip install -e .
# 验证安装
python -c "import data_analysis_agent; print('安装成功')"
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
data-analysis-agent --help
# 基本用法
data-analysis-agent input_file -o output_file
# Python 代码中调用
import data_analysis_agent
# 示例
result = data_analysis_agent.process("input")
print(result)
# data-analysis-agent 配置文件示例（config.yml） app: name: "data-analysis-agent" debug: false log_level: "INFO" # 运行时指定配置文件 data-analysis-agent --config config.yml # 或通过环境变量配置 export DATA_ANALYSIS_AGENT_API_KEY="your-key" export DATA_ANALYSIS_AGENT_OUTPUT_DIR="./output"
简介
<p align="center"> <img src="./Information/assets/Banner.png" alt="智能商业分析 Agent Banner" width="100%" /> </p>
<a href="https://trendshift.io/repositories/29216?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-29216" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/29216/daily?language=JavaScript" alt="Zafer-Liu%2FData-Analysis-Agent | Trendshift" width="250" height="55"/></a>
</div>
一个面向商业分析场景的 AI Agent。 连接数据源后，用户只需使用自然语言提问，系统即可自动完成： - 数据结构识别 - SQL 生成与执行 - 图表生成 - 业务洞察分析
© 2026 Zafer-Liu · 已申请中国计算机软件著作权（受理号 2026R11S0817877，软件名称：自然语言交互式经营数据分析软件 V1.0）· 采用 CC BY-NC 4.0 授权，禁止未授权商业使用，商用请联系作者。
💬 官方交流群： QQ 群 991636855 · Telegram 群 · Discord
<p align="center"> <a href="https://sage-agent.online/">🌐 官方网站</a> · <a href="#changelog">📝 更新日志</a> · <a href="#features">✨ 项目亮点</a> · <a href="#agent-manager">🧩 推荐管理</a> · <a href="#install">⚙️ 安装说明</a> · <a href="#examples">📈 使用示例</a> · <a href="#llm-config">🤖 LLM配置</a> · <a href="#faq">❓ FAQ</a> </p>
<details> <summary><strong>📚 完整目录</strong></summary>
<br>
</details>
---
<a id="changelog"></a>
✨ 项目亮点
智析Agent是一个对话式商业数据分析智能体，目标是让非技术用户也能像"聊天"一样完成数据分析。
上传 Excel / CSV，或连接数据库后，用户可以直接提问：
最近三个月销售额趋势如何？
哪个地区利润最高？
帮我生成用户增长图系统会自动：
- 理解问题意图
- 分析数据结构（Schema）
- 自动生成 SQL
- 执行查询
- 自动推荐图表
- 输出业务洞察
并通过 SSE（Server-Sent Events）流式输出，实时展示分析过程。
---
<a id="demo"></a>
🧠 核心能力
2️⃣ 多数据源支持
支持上传和连接多种数据源：
- 文件：Excel / CSV
- 数据库：SQLite、MySQL、PostgreSQL、SQL Server
- 未来计划：DuckDB、Spark
⚙️ 安装说明
🖥️ 方式 1：Windows 安装包（最简单，推荐）
从 GitHub Releases 下载最新版本：
| 平台 | 文件 |
|---|---|
| Windows | BusinessAnalyticsAgent_v1.2.0_LTS.exe |
前置要求：Python 3.10+、Windows 10 / 11 64 位。
双击安装包并按提示安装。安装完成后，从桌面或开始菜单启动 Business Analytics Agent。
---
方式 3：一键在线安装
Windows（在 PowerShell 中运行）：
iwr -useb https://raw.githubusercontent.com/Zafer-Liu/Data-Analysis-Agent/main/install.ps1 | iex安装完成后双击桌面的 data-analysis-agent.bat 启动，或：
cd $env:USERPROFILE\.data-analysis-agent\Data-Analysis-Agent
.\.venv\Scripts\activate
python app.pymacOS / Linux（在终端中运行）：
curl -fsSL https://raw.githubusercontent.com/Zafer-Liu/Data-Analysis-Agent/main/install.sh | sh安装完成后运行：
data-analysis-agent如提示 command not found，将以下内容添加到 ~/.zshrc 或 ~/.bashrc，然后重启终端：
export PATH="$HOME/.local/bin:$PATH"---
🎬 产品演示
一图胜千言，一段演示胜万图。
https://github.com/user-attachments/assets/4cc6f9d7-52d9-42c5-b3e7-059019f67275
</div>
<p align="center"> <em>演示视频 - 中文</em> </p>
---
<a id="agent-manager"></a>
📈 使用示例
示例 1：趋势分析
用户输入：
最近 12 个月销售趋势系统输出：
- SQL 查询
- 趋势折线图
- 销售增长分析
---
示例 2：区域分析
用户输入：
哪个地区利润最高？系统输出：
- 地区利润排行
- 柱状图
- 区域经营洞察
---
示例 3：图表优先模式
用户输入：
/chart 用户增长情况系统会优先生成可视化图表。
---
<a id="llm-config"></a>
🤖 LLM 配置说明
在侧边栏 ⚙ 中填写：
API Key
Base URL
Model即可切换模型。
---
<a id="faq"></a>
☁️ 赞助 · Sponsored by APIMart
<p align="center"><a href="https://go.apimart.ai/gh-data-analysis-agent"><img src="./Information/assets/APIMart.png" alt="APIMart banner" width="240" height="80" /></a></p>
感谢 APIMart 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，GPT-Image-2 低至 $0.006/张，1 美元可出图 160+ 张。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过此注册链接注册即可开用。
---
5️⃣ 多模型兼容
支持以下模型服务：
- DeepSeek
- OpenAI
- AtlasCloud
- 任意 OpenAI SDK Compatible API
并支持自定义 base_url、model、api_key。默认配置如下：
| Provider | Default Model |
|---|---|
| DeepSeek | deepseek-v4-flash |
| OpenAI | gpt-4o-mini |
| AtlasCloud | deepseek-v4-pro |
❓ FAQ
<details> <summary><b>📦 安装与启动</b></summary>
<br>
<details> <summary><b>安装依赖时网络超时？</b></summary>
脚本会自动切换清华源重试。
若仍失败，请手动执行：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple</details>
<details> <summary><b>pip install 报错 / 安装依赖失败？</b></summary>
脚本会自动切换国内镜像（清华源）重试。
若仍失败，请手动指定镜像：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple同时请确保磁盘至少保留 2 GB 可用空间。
</details>
<details> <summary><b>Python 版本不对（需要 3.10+）？</b></summary>
查看当前版本：
python --version如果版本低于 3.10，请前往：
https://www.python.org/downloads/
下载并安装最新版本。
</details>
<details> <summary><b>start.bat 双击没反应或一闪而过？</b></summary>
Python 未正确加入系统 PATH。
重新安装 Python 时勾选 "Add Python to PATH"，然后重启电脑再试。
</details>
<details> <summary><b>macOS 运行 start.command 被系统阻止？</b></summary>
在终端执行以下命令解除限制：
xattr -d com.apple.quarantine /你的路径/start.command如果提示：
"无法打开，因为无法验证开发者"
可以：
- 右键点击
start.command - 选择"打开"
- 再次点击"打开"
</details>
---
<details> <summary><b>🔑 API 配置</b></summary>
<br>
<details> <summary><b>提示未配置 LLM？</b></summary>
在侧栏 ⚙ 中填写 API Key 并保存。
</details>
<details> <summary><b>如何获取 API Key？</b></summary>
这里以 DeepSeek 为例：
</details>
</details>
---
<details> <summary><b>为什么 MySQL 能连接，但 SQL Server 无法连接？</b></summary>
SQL Server 连接除本程序安装的 pyodbc Python 包外，还依赖 Windows 中的 Microsoft ODBC Driver 17 或 18 for SQL Server。 pyodbc 仅负责让 Python 调用 ODBC；实际的 SQL Server 认证、加密和网络通信由 Microsoft ODBC Driver 完成。
安装驱动并重启程序后，使用与已安装驱动版本一致的连接串。例如安装 ODBC Driver 18：
mssql+pyodbc://用户名:密码@服务器:1433/数据库名?driver=ODBC+Driver+18+for+SQL+Server&TrustServerCertificate=yes如果仍不能连接，请依次确认：SQL Server 已启用 TCP/IP；地址和端口正确（通常为 1433）； 服务器防火墙已放行该端口；以及用户名、密码和数据库访问权限有效。命名实例建议改填实际 TCP 端口， 例如 服务器:1433，避免实例发现被网络策略阻断。
</details>
---
<details> <summary><b>🗄️ 数据库连接</b></summary>
<br>
<details> <summary><b>如何连接 SQL 数据库？</b></summary>
请使用以下格式连接：
mysql+pymysql://用户名:密码@主机:端口/数据库名SQL Server（Windows）请使用 ODBC 连接串；首次使用还需安装 Microsoft ODBC Driver 17 或 18 for SQL Server：
mssql+pyodbc://用户名:密码@服务器:1433/数据库名?driver=ODBC+Driver+18+for+SQL+Server&TrustServerCertificate=yes若使用命名实例，请优先在 SQL Server 配置管理器中启用 TCP/IP，并填写实际 TCP 端口， 例如 服务器:1433，以避免实例发现被网络或防火墙阻断。
示例：
❌ 错误写法：
mysql://user:pass@host:3306/dbname✅ 正确写法：
mysql+pymysql://user:pass@host:3306/dbname</details>
</details>
---
<details> <summary><b>📊 图表与文件</b></summary>
<br>
<details> <summary><b>图表链接重启后失效？</b></summary>
生成的图表保存在本地目录：
outputs/charts可直接使用浏览器打开对应的 HTML 文件。
</details>
</details>
---
<a id="contributing"></a>
Data-Analysis-Agent 是一款专为商业场景设计的对话式数据分析智能体。它旨在打破技术壁垒，让非技术背景的用户也能通过自然语言对话，像聊天一样轻松完成复杂的数据查询与分析任务，实现从数据读取到业务洞察的智能化转型。
本项目核心亮点在于其强大的意图理解与自动化执行能力。用户只需上传 Excel、CSV 文件或连接 SQLite、MySQL、PostgreSQL 等数据库，即可通过自然语言提问。系统会自动解析数据 Schema、生成并执行 SQL、推荐可视化图表，并利用 SSE（Server-Sent Events）技术实现分析过程的实时流式输出，提供极佳的交互体验。
在开始使用前，请确保您的系统环境满足以下要求：Windows 用户需具备 Windows 10/11 64 位系统及 Python 3.10+ 环境；若通过源码安装，请确保已安装必要的 Python 依赖库。
项目提供多种灵活的安装方式以适配不同用户需求：Windows 用户推荐直接从 GitHub Releases 下载最新的 .exe 安装包进行一键安装；开发者可以通过 PowerShell 或终端运行官方提供的在线安装脚本实现自动化部署；此外，也支持传统的 Git Clone 源码安装及手动配置虚拟环境的方式。
安装完成后，您可以通过运行 `python app.py` 启动应用。项目内置了直观的产品演示视频，帮助您快速上手。在实际使用中，您只需在界面中上传数据文件，即可开始与 Agent 进行交互，体验自动化数据分析的魅力。
为了保障数据的安全性与灵活性，用户可以在侧边栏的配置面板中自定义 LLM 参数。您可以自由填写 API Key、Base URL 以及指定的 Model 名称��从而无缝切换 DeepSeek、OpenAI 或 AtlasCloud 等不同的模型服务，甚至支持任何兼容 OpenAI SDK 的自定义 API。
本项目具备高度的模型兼容性，支持 DeepSeek、OpenAI 及 AtlasCloud 等主流模型服务。通过集成先进的 Agent 工作流，系统能够根据用户输入的指令，自动完成从意图识别、SQL 生成到最终业务洞察输出的全链路闭环。
针对开发者可能遇到的问题，我们提供了详细的 FAQ 指南。例如，若在安装依赖时遇到网络超时，脚本会自动尝试切换至清华大学等国内镜像源；若 pip install 报错，建议手动指定国内镜像地址以提升下载成功率。
aiskill88点评：该工具将 Agent 与数据可视化深度结合，极大地降低了数据分析门槛，实用性极强且社区活跃度高。
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- Python 依赖冲突：建议用 venv / uv 隔离环境
- CLI：直接 npm install -g / pip install，命令行调用
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 构建多智能体协作系统的 Agent 开发者
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +Apache-2.0 协议，可免费商用
- +AI Skill Hub 精选推荐
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：智能数据分析助手 的核心功能完整，质量优秀。对于AI爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | Data-Analysis-Agent |
| 原始描述 | 开源AI工作流：🚀这是一个由 LLM 驱动的智能数据分析助手。通过对话式交互，自动生成可视化报表与商业洞察，让数据决策变得像聊天一样简单。 🚀 Say goodbye t。⭐2.0k · Python |
| Topics | 数据分析自动化报表商业智能 |
| GitHub | https://github.com/Zafer-Liu/Data-Analysis-Agent |
| License | Apache-2.0 |
| 语言 | Python |
收录时间：2026-07-02 · 更新时间：2026-07-03 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。