simba

开箱即用的生产级AI客服，自带评测与监控

Simba 是一个开源的、生产就绪的客服系统，基于 TypeScript 构建，内置了评估（Evals）和监控功能。它旨在解决客服场景中 AI 助手质量难以把控、缺乏系统化评测与观测的问题。核心能力包括：提供完整的客服对话流程管理，支持接入多种大语言模型，内置评估体系用于自动化测试和优化客服机器人的回复质量，同时提供实时监控面板以追踪系统性能、用户满意度和异常情况。项目强调生产可用性，注重部署的稳定性和可扩展性，适合需要快速搭建高质量 AI 客服平台并持续迭代的团队。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1543

维护状态低维护

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队GitHamza0206

所属国家

官网地址https://simba.mintlify.app

GitHubhttps://github.com/GitHamza0206/simba

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型customer-service,evals,knowledge-base,llm,rag

GitHub 星标★ 1543

30天Star增速

HF 下载量

上线时间2024-12-20 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

Docker（README 推荐的运行方式）
Python 与 pip（手动安装 simba-core 用）
Node.js 环境（前端与 npm 包 simba-chat-widget 相关）
OpenAI API Key（调用大模型必需）
可选：Claude Code（用于 /setup 一键安装）

安装与启动步骤

1克隆项目代码

把 Simba 仓库下载到本地并进入项目目录，后续命令都在该目录中执行。
```
git clone https://github.com/GitHamza0206/simba.git
cd simba
```
2写入 API 密钥

在项目根目录创建 .env 文件，填入 OpenAI 密钥，供服务调用大模型使用。
```
echo "OPENAI_API_KEY=sk-xxxxxxxx" > .env
```
3用 Docker 启动

README 推荐 Docker 方式启动，但节选里运行命令被截断，需到官网查看完整命令。
4手动安装核心包

不想用 Docker 时，可用 pip 安装官方发布的 simba-core 包。
```
pip install simba-core
```
5启动后端与前端

先运行 simba server 启动后端服务，再运行 simba front 启动前端界面。
```
simba server
simba front
```
6Claude Code 一键安装

使用 Claude Code 时可用该命令自动装好 Python、前端与 npm 依赖并拉起基础服务。
```
/setup --all
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	调用大模型所需的 OpenAI 密钥，写在项目根目录 .env 文件中	`sk-xxxxxxxx`

如何确认成功

终端出现服务启动日志、能打开 Simba 前端客服界面即为成功，具体端口以官网文档为准。

常见问题

Q：Docker 启动的具体命令是什么？

A：README 节选中该命令被截断，请以官网文档 https://simba.mintlify.app 或仓库 README 的完整内容为准，不要凭猜测执行。

Q：必须用 Docker 吗？

A：不是。README 同时提供了手动方式：pip install simba-core 安装后，用 simba server 和 simba front 启动前后端。

Q：只想装其中一部分怎么办？

A：使用 Claude Code 时可用 /setup --backend 只装 Python 依赖、/setup --frontend 只装 Next.js 与 simba-chat、/setup --services 只启动 Docker 基础服务。

Q：没有 OpenAI API Key 能跑起来吗？

A：README 的快速开始只要求配置 OPENAI_API_KEY，缺少密钥时模型相关功能无法正常工作。

注意事项

README 节选里的 Docker 运行命令不完整，请勿自行拼凑，以官网 https://simba.mintlify.app 为准。
.env 文件中含密钥，不要提交到 Git 仓库或公开分享。
Docker 部署与 pip 手动安装二选一即可，不必同时执行。
项目技术栈为 TypeScript，涉及前端与 npm 包，安装前确认 Node.js 环境可用。

核心亮点

内置Evals评估体系，可自动化测试客服回复质量，减少人工回归成本
提供实时监控面板，直观追踪系统性能与用户满意度，便于快速定位问题
基于TypeScript，类型安全，代码结构清晰，易于二次开发和维护

不足之处

文档/社区待观察
项目较新，生态和插件相对较少，深度定制可能需要自行探索

适用场景

企业快速搭建AI客服机器人，并需要持续评估回复效果
客服团队希望监控AI交互质量，及时优化模型提示词和流程
开发者需要一套可扩展的客服系统框架，集成到现有业务中

替代项目

Rasa、Botpress、Chatwoot

项目介绍

simba 是行业应用领域的开源项目，由 GitHamza0206 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,543）位列前 30%，在行业应用分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,461 增加到 1,543，净增 82。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自行部署，完全免费。

它主要面向的使用场景是：企业快速搭建AI客服机器人，并需要持续评估回复效果。同类可对比的替代方案包括 Rasa、Botpress、Chatwoot。

上一篇：video-search-and-summarization

下一篇：contoso-real-estate