English | 中文

Spider AI

平凡学习,非凡帮助 — 你的好邻居 AI

Python FastAPI License


一个会自主学习的 AI 助手。当你休息时它在思考,当你需要时它早已就位。

不止是工具,更像一位懂你不打扰的好邻居。

演示

核心能力

  • SSE 流式对话 —— 双答案并行生成,Markdown 与 KaTeX 实时渲染
  • 三级记忆系统 —— 感觉 → 工作(Redis)→ 长期(Qdrant 向量检索)
  • MCP 工具热插拔 —— Docker 化 MCP Server,能力市场按需加载
  • 子代理编排 —— Supervisor 动态派遣专家代理,绑定工具完成复杂任务
  • 学习引擎 —— 全量 / 增量 / 定时三模式,三重去重沉淀长期知识
  • 在线 IDE —— Monaco 编辑器集成,代码即对话,项目级 Agent 协作

技术栈

React 18 · Vite · TailwindCSS · FastAPI · LangChain · SQLModel · openGauss · Redis · Qdrant · DashScope · vLLM · Docker

架构

        Frontend  (React · Vite · Tailwind)
               │
        API Gateway  (FastAPI)
  Auth · Chat(SSE) · Memory · Learn · MCP · Agents
               │
     ┌─────────┼──────────┐
     ▼         ▼          ▼
 openGauss   Redis     Qdrant
               │
   Inference: DashScope  +  Local vLLM

快速启动

Python ≥ 3.12 · Node.js ≥ 18 · openGauss · Redis · Qdrant

# 后端
cd spider_base
cp .env.example .env
uv sync
uvicorn main:app --reload --host 0.0.0.0 --port 9111

# 前端
cd spider_front
npm install
npm run dev          # http://localhost:5173

# MCP 工具(可选)
cd spider_base/docker; .\start-mcp.ps1

项目结构

Spider_AI/
├── spider_base/      后端 FastAPI 服务(api · core · docker · main)
├── spider_front/     前端 React 应用(components · api · App.jsx)
└── spider_man/       学习引擎模块

Roadmap

  • 主动定时任务与长期自主执行项目
  • 音视频与生成式多模态集成
  • 完善剩余模块与功能
  • 优化数据存储与虚拟化部署
  • 补全README文档和vllm部署等环境的使用

License

MIT © Spider AI

能力越大,责任越大。