⚙️ 环境配置
💡环境配置要求
在开始之前,请确保您的开发环境满足以下最低配置要求:
- 操作系统:Windows 10/11, macOs M系列, Centos/Ubuntu
- GPU: 本地使用ollama部署,推荐使用Nvidia显卡或CPU模式。推荐公网购买APIKEY形式
- 内存:8GB+
🔧 前置条件
- Python 3.11.x
- uv 0.8.0+
- Dify 0.7.1+
- Mysql 8.0+
- Node.js 18.12.x+
- Pnpm 9.x
- Mcp-Hub 0.9.0+
- Gpt-vis-api 0.0.1+
📚 大模型选择
- 推荐购买公网大模型阿里云公网大模型服务APIKEY
- 模型要求: 默认使用openai/sdk基本支持所有模型
- 模型支持: 本地模式(ollama, vllm...) 公网模式(deepseek, qwen3...)
1. Clone仓库
git clone https://github.com/apconw/sanic-web.git
2. 复制配置文件
进入docker目录,复制.env.template文件为.env
cd docker
cp .env.template .env
3. 执行部署脚本
执行部署脚本报错请查看当前目录下deploy.log报错信息
cd docker
# mac或linux环境
./deploy.sh
# Windows环境
./deploy.bat
4. 中间件配置
🌲 Mino
下面chat-service/gpt-vis-api服务都依赖Minio服务
配置
- 访问MinIO服务,http://localhost:19001/ 账号:admin 密码:12345678
- 创建两个个bucket,名称filedata和chart-images 同时配置Access Key保存好下面会使用
- 修改bucket的chart-images访问策略为public

🌵 mcp-hub
-
⚠️ deploy.sh脚本已经初始化好了默认工具不用手动安装配置了
-
mcp-hub是一个开源的MCP聚合工具方便安装和管理MCP工具

配置
- 登录http://localhost:3300/ admin/admin123
- 国内镜像配置
- Python 包仓库地址: https://mirrors.aliyun.com/pypi/simple
- NPM 仓库地址: https://registry.npmmirror.com

🌵 langfuse (可选)
- 链路追踪组件
- 官方文档
- 部署启动
# Get a copy of the latest Langfuse repository
git clone https://github.com/langfuse/langfuse.git
cd langfuse
# Run the langfuse docker compose
docker compose up