Rasa · 开源对话式 AI 框架 · 本地安装与使用全指南
项目仓库： https://github.com/RasaHQ/rasa
开源协议：Apache License 2.0 · 语言：Python · 分发：PyPI
rasa · 依赖管理（开发）：Poetry · 文档站：rasa.com/docs · 仓库分支：main
维护模式提示（官方 README 顶部）：Rasa Open Source 目前处于维护模式；官方未来方向是 Hello Rasa 与 CALM（Conversational AI with Language Models）。本文按经典 Rasa Open Source 框架给出安装与使用路径。
1 项目简介
Rasa 是一个开源机器学习框架，用于自动化文本与语音对话。基于 Rasa 可以构建具备上下文理解能力的对话助手，接入 Facebook Messenger、Slack、Telegram、Twilio、Microsoft Bot Framework、Rocket.Chat、Mattermost、Webex Teams 以及自定义对话渠道。它面向多轮、来回往返的复杂对话场景。
官方当前主推的新方向是 Hello Rasa（基于 CALM 引擎的对话式 AI 游乐场），由 LLM 负责对话理解、业务代码负责规则约束。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Rasa Open Source |
| 仓库地址 | github.com/RasaHQ/rasa |
| 项目定位 | 开源对话式 AI / 对话自动化框架 |
| 开源协议 | Apache License 2.0 |
| 主要语言 | Python |
| 分发 | PyPI 包 rasa |
| 开发依赖管理 | Poetry |
| 官方文档 | rasa.com/docs/rasa |
| 官方游乐场 | Hello Rasa |
| 状态 | 维护模式 |
1.2 适用场景
- 想在本地构建可管理多轮对话的助手，自定义意图、动作与对话流程。
- 需要把助手接入 Messenger / Slack / Telegram / 自定义渠道。
- 研究对话式 AI 架构、NLU 与对话管理。
1.3 能力边界（官方口径）
- 经典 Rasa Open Source 已进入维护模式，新功能以 Hello Rasa / CALM 为准。
- 官方文档与安装说明针对经典框架；最新体验见 Hello Rasa。
2 功能特性
- 上下文对话：处理多轮、来回往返的复杂对话。
- 多渠道接入：Messenger、Slack、Hangouts、Webex、Microsoft Bot Framework、Rocket.Chat、Mattermost、Telegram、Twilio、自定义渠道。
- NLU + 对话管理：意图识别与对话策略由框架统一编排。
- 可扩展：动作、自定义 NLU 组件与 SDK 集成。
- 企业平台可选：可扩展到 Rasa Platform。
3 官方界面预览
本仓库 README 未提供界面截图，实际开发与对话界面见官方文档与 Hello Rasa 游乐场。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/RasaHQ/rasa | 源码与开发说明 |
| 官方文档 | https://rasa.com/docs/rasa/ | 经典框架文档 |
| 环境安装 | environment-set-up | 官方安装指南 |
| 学习中心 | learning.rasa.com | 对话式 AI 课程 |
| Hello Rasa | https://hello.rasa.ai/ | 官方新一代游乐场 |
| PyPI | badge.fury.io/py/rasa | 版本徽章 |
5 前置要求与服务器配置
5.1 软件前提
- Python：按 PyPI
rasa包支持的 Python 版本安装（见官方环境安装文档）。 - pip / venv：建议虚拟环境隔离。
- Poetry（仅开发源码时需要）：用于打包与依赖管理。
5.2 硬件建议
| 项目 | 建议 |
|---|---|
| 训练 | 视模型规模，建议 8 GB 以上内存 |
| 部署 | CPU 即可跑小型对话助手 |
| 操作系统 | Linux / macOS / Windows |
6 方式一：pip 安装（推荐起步）
# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 安装 Rasa
pip install rasa
# 查看版本与命令
rasa --help官方环境安装文档：rasa.com/docs/rasa/installation/environment-set-up。
7 方式二：源码开发安装
官方 README 给出的开发路径基于 Poetry：
# 1. 安装 Poetry（见 python-poetry.org）
# 2. 克隆后安装
git clone https://github.com/RasaHQ/rasa.git
cd rasa
make install
# macOS 编译问题时先导出
export SYSTEM_VERSION_COMPAT=17.1 测试命令
make prepare-tests-ubuntu # Ubuntu/Debian
make prepare-tests-macos # macOS
make test8 配置项说明
| 配置 | 位置 | 说明 |
|---|---|---|
| 对话配置 | config.yml（项目内） |
NLU 与对话策略配置 |
| 领域文件 | domain.yml（项目内） |
意图、动作、响应定义 |
| 数据 | data/（项目内） |
NLU 与规则/故事数据 |
| 渠道 | 运行时配置 | Messenger/Slack/Telegram 等渠道凭据 |
具体工程文件结构以官方文档为准。
9 常用运维命令
# 查看命令
rasa --help
# 初始化示例项目（官方推荐的入门方式）
rasa init
# 训练模型
rasa train
# 命令行对话
rasa shell
# 以 HTTP 服务运行
rasa run10 常见故障排查
- Python 版本不兼容：按 PyPI 与官方环境安装文档选择受支持的 Python 版本，使用虚拟环境。
- macOS 编译报错：官方建议安装前
export SYSTEM_VERSION_COMPAT=1。 - 依赖冲突：用干净虚拟环境安装，避免与系统 Python 混用。
- 新功能缺失：经典框架已维护模式，新体验请用 Hello Rasa。
11 风险与合规说明
- 许可证：Apache License 2.0，可自由使用与二次开发。
- 维护模式：官方明确其进入维护模式，新项目建议评估 Hello Rasa / CALM。
- 渠道凭据：接入 Messenger/Telegram 等渠道时妥善保管 API 凭据。
- 非官方声明：本文基于官方仓库 README 与 PyPI 信息整理，命令以官方文档最新为准。