GeoAgent

English

> 用自然语言操控地图，AI 自动完成数据接入 → 空间分析 → 可视化渲染 → 报告生成

• 自然语言交互：对话式操控地图，无需编写代码
• 35+ GIS 工具：缓冲区分析、空间查询、聚类、核密度、填色图、热力图等
• 高德地图集成：POI 搜索、周边搜索、地理编码、路径规划、天气查询
• Cesium 3D 地球：GeoJSON 渲染、3D Tiles、地形服务、影像服务、轨迹动画
• 智能报告：自动生成 Markdown 分析报告，支持下载
• 流式输出：SSE 实时推送 AI 思考过程、工具调用、地图指令
• 多语言支持：中文 / English 界面一键切换，AI 回复语言跟随
• 自定义 LLM：支持在前端配置 API Key / Base URL / Model，兼容 OpenAI / DeepSeek / 通义千问等

| 层级 | 技术 | |------|------| | 前端 | Vue 3 + TypeScript + Cesium + Pinia + ECharts | | 后端 | Python + FastAPI + LangChain/LangGraph | | GIS | gis-mcp + 高德地图 API + GeoPandas + Shapely + PyProj | | 数据库 | SQLite（开发）/ PostGIS（生产） | | Bridge | cesium-mcp-bridge（npm 包） |

• Node.js >= 18
• Python >= 3.11
• LLM API Key（DeepSeek / OpenAI / 通义千问）

git clone https://github.com/gaopengbin/GeoAgent.git
cd GeoAgent

cd backend
python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # Linux/macOS

pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env，填入 LLM API Key

python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

cd frontend
npm install
npm run dev
# 访问 http://localhost:5173

# 配置环境变量
cp backend/.env.example backend/.env
# 编辑 backend/.env，填入 LLM API Key 和 Cesium Token

docker-compose up --build
# 前端：http://localhost:5173  后端：http://localhost:8000

点击右上角设置面板中的 中文 / EN 按钮即可切换界面语言。切换后：

• 所有 UI 文案自动切换
• AI 的 System Prompt 跟随当前语言
• 语言偏好保存在 localStorage

在设置面板中可配置自定义 LLM 连接：

• API Key：你的 LLM 提供商密钥
• Base URL：API 基础地址（如 https://api.openai.com/v1）
• Model Name：模型名称（如 gpt-4o、deepseek-chat）

配置后点击"应用配置"，后续对话将使用你的自定义模型。未配置时使用服务端 .env 中的默认模型。

GeoAgent/
├── backend/                    # Python 后端
│   └── app/
│       ├── agent/              # LangGraph Ag