simba

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 116 🐛 待处理 5 👀 关注 9
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1547
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0 许可证,可自行部署,完全免费。

项目预览

simba 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队GitHamza0206
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0 许可证,可自行部署,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型customer-service,evals,knowledge-base,llm,rag
GitHub 星标★ 1547
上线时间2024-12-20 00:00:00
代码更新2026-06-18
仓库体积33.2 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1547

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

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

环境要求

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

安装与启动步骤

  1. 1克隆项目代码

    把 Simba 仓库下载到本地并进入项目目录,后续命令都在该目录中执行。

    git clone https://github.com/GitHamza0206/simba.git
    cd simba
  2. 2写入 API 密钥

    在项目根目录创建 .env 文件,填入 OpenAI 密钥,供服务调用大模型使用。

    echo "OPENAI_API_KEY=sk-xxxxxxxx" > .env
  3. 3用 Docker 启动

    README 推荐 Docker 方式启动,但节选里运行命令被截断,需到官网查看完整命令。

  4. 4手动安装核心包

    不想用 Docker 时,可用 pip 安装官方发布的 simba-core 包。

    pip install simba-core
  5. 5启动后端与前端

    先运行 simba server 启动后端服务,再运行 simba front 启动前端界面。

    simba server
    simba front
  6. 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

同类项目推荐

alphafold3 开源

输入生物序列,直接预测复合物三维结构

AlphaFold 3 inference pipeline.

★ 8748 2026-10-25
opentakeoff 开源

浏览器里从PDF图纸量房算料,AI可直接调用

Open-source (AGPL-3.0) PDF takeoff for construction & flooring — the first engine a···

★ 779 2026-10-19
RTranslator 开源

手机本地实时翻译,不联网也能聊遍全球

Open source real-time translation app for Android that runs locally

★ 10622 2026-08-10
zhilv-yuntu 开源

说句话就生成可落地的中文旅行行程

An AI travel planning system built with FastAPI, LangChain, ChromaDB, and AMap servi···

★ 369 2026-09-12
mavsdk_drone_show 开源

用 Python 轻松调度无人机集群,从仿真到表演一站式搞定。

Open-source MAVLink fleet operations for PX4: SITL, drone shows, search and rescue, ···

★ 338 2026-08-09
Asterics-AAC 开源

免费离线AAC应用,让沟通障碍者轻松表达并控制智能家居

Free, easy-to-use AAC app with offline support, flexible input options, media & smar···

★ 129 2026-08-09
cardiobot 开源

专注心血管健康的智能问答助手,快速获取可靠医学知识

Cardio chatbot is trained on carefully curated datasets related to cardiovascular di···

★ 115 2026-08-09
UGTLive 开源

屏幕上的外文,实时变母语字幕。

Live AI-powered screen translation via LLMs & GPU OCR. 26 languages, manga support, ···

★ 117 2026-09-19
aurora 开源

用AI预测地球天气,秒级出结果,替代传统数值预报

Implementation of the Aurora model for Earth system forecasting

★ 1043 2026-08-09