Zafer-Liu/Data-Analysis-Agent

📊 Data‑Analysis‑Agent (智析 Agent)

何であるか – 非技術者でも自然言語の質問を入力するだけでビジネスデータを分析できるオープンソースの会話型AIエージェント。Excel/CSVファイルやリレーショナルデータベースに接続し、スキーマを自動的に推論し、SQLを生成・実行、適切なPlotlyチャートを選択してレンダリングし、ビジネスインサイトをテキストで返します。

主な機能

• 自然言語からSQLへ – クエリを手動で書く必要なし。LLMがユーザーの意図をSQLに変換して実行します。
• マルチソース対応 – Excel、CSV、SQLite、MySQL、PostgreSQL、SQL Server（今後：DuckDB、Spark）。
• 自動チャート生成 – 6つのカテゴリ（トレンド、比較、分布、地理、関係、割合）の41種類のチャートタイプから選択し、Plotlyでレンダリングします。
• ストリーミングフィードバック – Server-Sent Eventsを使用して、ステップバイステップのプログレスバー（スキーマ検出 → SQL生成 → 実行 → チャートとインサイト）を表示します。
• LLM非依存 – OpenAI互換API（OpenAI、DeepSeek、AtlasCloudなど）と連携可能。base_url、model、api_keyをカスタマイズできます。
• 高度な分析 – 外れ値処理、パーセンタイルグループ化、K-meansクラスタリング、決定木モデリングをサポート。結果をExcel、DOCX、PPT形式でエクスポート可能。
• 拡張可能 – ローカルまたはリモートの「MCP」を接続して追加機能を提供し、ビジネス知識ベースをインジェストできます。

導入方法

1. Windowsインストーラ – リリースページから BusinessAnalyticsAgent_v1.2.0_LTS.exe をダウンロードし実行（Python 3.10+必須）。
2. クロスプラットフォームzip – ソースzipをダウンロードし、start.bat（Windows）またはstart.command（macOS）を実行。仮想環境を作成し、依存関係をインストール、http://localhost:5001でFlaskサーバーを起動します。
3. ワンクリックスクリプト – 提供されたPowerShell（install.ps1）またはシェル（install.sh）スクリプトを実行してグローバルインストールし、data-analysis-agentコマンドを追加します。
4. 手動クローン – git clone https://github.com/ZaVar‑Liu/Data-Analysis-Agent.git && pip install -r requirements.txt && python app.py。

通常のワークフロー

> 最近 12 个月销售趋势
[1/4] 读取数据结构…
[2/4] 生成 SQL…
[3/4] 执行查询…
[4/4] 生成折线图并给出增长分析

チャートを強制指定（/chart …）、SQLを直接実行（/sql …）、またはより深い分析を実行（/kmeans、/tree）することもできます。

設定 – UIサイドバーの ⚙ から、LLMのAPIキー、オプションのbase URL、モデル名を入力。デフォルトモデルは deepseek‑v4‑flash（DeepSeek）と gpt‑4o‑mini（OpenAI）です。

拡張・貢献 – プロジェクトはPEP 8準拠、コンベンショナルコミットを使用。バグ修正、新しいチャートタイプ、高度な分析のPRを歓迎します。ワークフローは CONTRIBUTING.md を参照してください。

ライセンス – CC BY-NC 4.0（非営利利用のみ；営利利用は作者よりライセンス取得可能）。

---

詳細は、READMEの Features、Installation、Slash Commands、および FAQ を参照してください。