介绍

🍚 RiceBall 是什么？

RiceBall 是一个开源的、全栈式的 AI 智能体与知识库平台。它旨在帮助团队和企业在私有环境中快速构建和部署基于大语言模型（LLM）的智能应用。

核心能力：

• 🔐 私有化 RAG 知识库：
  • 安全上传文档（PDF, DOCX, XLSX, PPTX, Markdown）。
  • 网页阅读器 (Web Reader)：自动提取任意网页正文并保存到知识库。
  • 基于 ChromaDB 自动进行切片和向量化。
  • 支持引用追踪。
• 🐍 代码解释器 (Code Interpreter):
  • 安全执行：在隔离的 Docker 容器沙箱中运行 Python 代码。
  • 数据分析：内置 Pandas, NumPy, Scikit-learn 等库，支持数理统计与可视化绘图。
  • 文件处理：支持读取用户上传的文件，并生成图表、报表（Excel/CSV）等文件供用户下载。
• 🤖 智能体 (Agent) 引擎：
  • 基于 LangChain 构建，利用强大的 工具调用 (Tool Calling) 能力执行任务。
  • 通用 MCP 支持 (Universal MCP)：完整实现 Model Context Protocol。
    • Stdio：连接本地命令行工具。
    • SSE：连接远程或 Docker 容器中的工具。
    • Presets：常用工具一键安装。
• 📱 多渠道集成 (Multi-Channel):
  • 全渠道支持: 一键将助手发布到 企业微信 (WeCom)、Telegram 等平台。
  • 访客管理: 自动将外部用户身份映射为内部“访客”账号，并隔离会话历史。
  • 流式响应: 即便在需要轮询的平台（如企业微信智能对话机器人）上，也能通过中间流缓冲支持打字机效果。
• ⏰ 定时任务 (Scheduled Tasks):
  • Cron 自动化: 基于 Cron 表达式自动触发 AI 交互任务。
  • 主动推送: 支持向企业微信、Telegram 等渠道主动发送消息。
  • 灵活投递: 支持发送到群组、部门或特定用户，不仅限于已绑定用户。
• 🧠 多模型支持：
  • 拒绝厂商锁定：支持 OpenAI, Anthropic, Google Gemini, XAI (Grok) 等主流厂商。
  • Ollama 集成：一键扫描并导入本地模型（DeepSeek, Llama3 等），支持私有化离线部署。
  • OpenAI 兼容：任何兼容 OpenAI 协议的模型（如阿里云 DashScope）均可接入。
  • 成本优化：简单问题路由到低成本模型，复杂推理交给高性能模型。
• 🛡️ 企业级 SSO & 认证:
  • 全面支持 OAuth 2.0 (Google, GitHub, Keycloak, Auth0)。
  • 原生集成 企业微信 (WeCom)，实现员工无缝登录。
• � OpenAI 兼容 API：
  • 将配置好的助手作为标准 OpenAI API 端点暴露。
  • 轻松集成现有工具（如 VS Code 插件或第三方客户端）。

🛠️ 技术栈

• 前端: Nuxt 4 (Vue 3), Shadcn Vue, TailwindCSS v4, Pinia
• 后端: FastAPI, SQLAlchemy (Async), Alembic
• AI & 数据: LangChain, ChromaDB, Pydantic
• 存储: PostgreSQL / SQLite, Redis, S3 (MinIO/AWS)

💡 为什么选择 RiceBall？

1. 安全优先：私有化部署方案确保数据和 IP 保留在你自己的基础设施上。
2. 业务原生：通过 工具调用 (Tool Calling) 和 通用 MCP 支持，RiceBall 不仅仅是一个聊天机器人，它是能够与处于任何环境（本地/远程）的业务系统（文件、数据库、API）进行交互的操作员。
3. 开发者就绪：清晰的模块化架构（前后端分离），是构建定制化 AI 解决方案的绝佳起点。

🔗 通用 MCP 主机 (Universal MCP Host)

RiceBall 实现了完整的 Model Context Protocol (MCP) 规范，作为通用主机（Universal Host）可以连接任何 MCP 服务器。

核心特性

• 🔌 全传输协议支持:
  • Stdio: 无缝连接本地进程（如 git、本地 Python 脚本）。非常适合本地开发和调试。
  • HTTP (Simple & SSE): 完整支持 HTTP 传输协议。使用 HTTP POST 发送消息，可选 Server-Sent Events (SSE) 进行流式传输。完美支持 Docker "Sidecar" 模式部署。
• 📦 智能预设 (Smart Presets): 内置常用工具配置（如本地文件系统、Brave 搜索 API 等），无需手动配置，一键安装即可使用。
• 📄 无限扩展: 通过管理后台添加自定义的 MCP 服务器连接信息，无限扩展你的助手能力。

👥 适用人群

• 企业与团队：构建内部知识库助手、智能客服、研发效能工具。
• 全栈开发者：寻找成熟的 RAG + Agent 架构作为起点的开发者。
• 系统集成商：为客户交付私有化 AI 解决方案的服务商。

🐹 关于名字

RiceBall （饭团）的名字来源于我养的一只仓鼠。它每次在小食盆里吃饭的时候团起来跟一个饭团似的，所以我给它起名叫饭团。