{"id":27046760,"url":"https://github.com/lucazou/table-agent","last_synced_at":"2025-04-09T18:35:18.955Z","repository":{"id":286129374,"uuid":"960316063","full_name":"LucaZou/table-agent","owner":"LucaZou","description":"基于FastAPI + LangChain + OpenAI API + Vue的AI表格处理工具，用于智能化处理和分析表格数据。","archived":false,"fork":false,"pushed_at":"2025-04-04T13:35:43.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T14:32:44.616Z","etag":null,"topics":["fastapi","langchain","openai"],"latest_commit_sha":null,"homepage":"https://www.uagent.top","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LucaZou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-04T08:16:11.000Z","updated_at":"2025-04-04T13:35:47.000Z","dependencies_parsed_at":"2025-04-04T14:42:49.227Z","dependency_job_id":null,"html_url":"https://github.com/LucaZou/table-agent","commit_stats":null,"previous_names":["lucazou/table-agent"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaZou%2Ftable-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaZou%2Ftable-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaZou%2Ftable-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucaZou%2Ftable-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LucaZou","download_url":"https://codeload.github.com/LucaZou/table-agent/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248088424,"owners_count":21045712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","langchain","openai"],"created_at":"2025-04-05T06:17:53.460Z","updated_at":"2025-04-09T18:35:18.942Z","avatar_url":"https://github.com/LucaZou.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# U-Agent: CSV 数据分析智能助手\n\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg) 一个允许用户上传 CSV/XLSX 文件并通过自然语言聊天界面与之交互，进行数据查询和分析的 Web 应用程序。\n\n## ✨ 功能特性\n\n* **CSV 文件上传**: 方便地上传本地 CSV /XLSX 数据文件。\n* **聊天式数据查询**: 通过类似聊天的界面，使用自然语言提问关于已上传数据的问题。\n* **智能数据分析**: 后端 Agent 利用数据处理库（如 Pandas）理解问题并从 CSV 中提取或计算答案。\n* **API 接口**: 基于 FastAPI 构建的健壮后端 API，提供清晰的接口文档 (Swagger UI)。\n* **响应式前端**: 基于 Vue.js 构建的现代化、用户友好的界面。\n* **容器化部署**: 使用 Docker 和 Docker Compose 提供一致的开发和生产环境。\n* **自动化部署脚本**: 简化在不同操作系统上的部署流程。\n* **文件管理**:  包含对上传文件的生命周期管理，自动清理文件。\n\n## 🚀 技术栈\n\n* **后端**: Python, FastAPI, Pandas, Uvicorn\n* **前端**: Vue.js, Vuex, Vue Router, Axios (或 Fetch API)\n* **数据库/存储**: (如果使用了数据库请列出，目前看主要是文件系统存储)\n* **部署**: Docker, Docker Compose\n* **开发工具**: Node.js, npm/yarn, Python venv/conda\n\n## 🔧 环境准备\n\n在开始之前，请确保你安装了以下软件：\n\n* Node.js (建议 LTS 版本) 和 npm 或 yarn\n* Python (建议 3.8+ 版本) 和 pip\n* Docker\n* Docker Compose\n\n## ⚙️ 本地开发设置\n\n1.  **克隆仓库**:\n```bash\ngit clone https://github.com/LucaZou/table-agent\ncd table-agent\n```\n\n2.  **启动后端**:\n```bash\ncd backend\npython -m venv venv  # 创建虚拟环境\nsource venv/bin/activate # 激活虚拟环境\npip install -r requirements.txt # 安装依赖\n# 建议在 .env 文件中配置环境变量（如 UPLOAD_FOLDER, SECRET_KEY 等，如果需要）\nuvicorn app.main:app --reload --host 0.0.0.0 --port 8000 # 启动服务 (端口可自定义)\n```\n\n后端 API 将运行在 `http://localhost:8000` (或你配置的地址)。API 文档位于 `http://localhost:8000/docs`。\n\n3.  **启动前端**:\n```bash\ncd ../frontend\nnpm install # 或 yarn install\n# 确保 .env.development 文件 (如果需要) 中配置了正确的后端 API 地址\nnpm run serve # 或 yarn serve\n```\n\n前端开发服务器将运行在 `http://localhost:8080` (或 package.json 中配置的其他端口)。\n\n## 🐳 使用 Docker 运行 (推荐)\n\n本项目已完全容器化，使用 Docker Compose 可以轻松启动整个应用。\n\n```bash\n# 在项目根目录 (table-agent)\ndocker-compose up --build\n```\n\n这将根据 `docker-compose.yml` 构建并启动后端和前端服务。\n* 前端通常可以通过 `http://localhost:8080` 访问。\n* 后端 API 通常可以通过 `http://localhost:8000` 访问。\n(请根据 `docker-compose.yml` 中定义的端口进行调整)\n\n\n## 🚀 部署\n\n本项目提供了简化部署的脚本：\n\n* **Linux/macOS**:\n```bash\nbash deploy-docker.sh\n```\n* **Windows (PowerShell)**:\n```powershell\n.\\deploy-docker.ps1\n```\n这些脚本通常会执行 `docker-compose -f docker-compose.yml up --build -d` 或类似命令来部署生产环境。请根据需要查看和修改脚本内容。\n\n## 📖 API 文档\n\nAPI文档可通过以下URL访问：\n- Swagger UI: http://localhost:8000/api/docs\n- ReDoc: http://localhost:8000/api/redoc\n- OpenAPI JSON: http://localhost:8000/api/openapi.json\n## 🤝 贡献\n\n\n## 📄 License\n\n本项目采用 [MIT License](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucazou%2Ftable-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucazou%2Ftable-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucazou%2Ftable-agent/lists"}