AI Agent - 高可用智能代理系统
基于 Ollama 本地模型的 AI Agent 开发框架,无需 API Key,支持高可用性和完整的对话管理。
✨ 特性
🚀 无需 API Key: 完全基于本地 Ollama 模型运行
💬 智能对话: 支持上下文记忆和多轮对话
🎯 高可用性: 内置重试机制、超时控制和错误处理
📊 完整监控: 实时统计、性能指标和健康检查
🎨 现代 UI: React + Tailwind CSS 构建的美观界面
💾 数据持久化: SQLite 数据库存储会话和历史
🔄 流式响应: 支持实时流式输出
⚙️ 灵活配置: 可自定义系统提示词、温度等参数
🚀 快速开始
1. 安装 UV
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
2. 安装 Ollama 并拉取模型
# 安装 Ollama (macOS)
brew install ollama
# 启动 Ollama 服务
ollama serve
# 拉取模型 (另开终端)
ollama pull qwen2.5:7b
3. 克隆并设置项目
# 克隆项目
git clone <repository-url>
cd ai-agent
# 创建虚拟环境并安装依赖
uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"
# 复制环境配置
cp .env.example .env
# 编辑 .env 根据需要调整配置
4. 安装前端依赖
cd frontend
npm install
5. 启动应用
# 终端 1: 启动后端
cd ..
python -m ai_agent.main
# 终端 2: 启动前端开发服务器
cd frontend
npm run dev
访问 http://localhost:5173 开始使用!