Zafer-Liu/Data-Analysis-Agent

📊 Data‑Analysis‑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-평균 클러스터링, 결정트리 모델링을 지원하며, 결과를 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 섹션을 참조하세요.