OpenVoiceOS (OVOS) 是一个免费、开源、尊重隐私的语音助手平台。你可以在树莓派、台式机或服务器上运行它——如果需要，可以完全离线运行，完全可定制，完全属于你。
新用户？ 最快上手的方法是使用下面预构建的发行版。无需手动设置。
OVOS 发行版是即用型捆绑包，已为特定硬件或平台预先配置好一切：
| 发行版 | 最适合 |
|---|---|
| ovos-installer | 推荐 — 任何 Linux 机器，交互式安装脚本 |
| raspOVOS | 树莓派镜像 (可能滞后于最新版本) |
| ovos-buildroot | 原始的 OVOS 镜像 — 暂停开发但未放弃，计划回归 |
ovos-installer 是参考发行版，也是新用户最受支持的路径。raspOVOS 是一个方便的 Pi 镜像，但可能不总是跟踪最新的 OVOS 版本。选择一个，按照其 README 操作，你将获得一个可工作的语音助手，而无需触碰此仓库中的任何内容。
如果你更喜欢管理自己的 Python 环境，可以直接使用 pip 安装 OVOS。
推荐的起点 — 一个完整的本地语音助手：
pip install ovos-core[mycroft,plugins,skills-essential] -c https://raw.githubusercontent.com/OpenVoiceOS/ovos-releases/main/constraints-stable.txt
包含所有内容 — 一站式安装：
pip install ovos-core[mycroft,lgpl,plugins,skills-essential,skills-audio,skills-gui,skills-internet,skills-media,skills-desktop] -c https://raw.githubusercontent.com/OpenVoiceOS/ovos-releases/main/constraints-stable.txt
-c 标志将所有 OVOS 包固定到我们稳定发布渠道中经过测试的兼容版本。
想了解
mycroft、plugins、skills-*和其他选项的含义吗？
请参阅 docs/installation.md 获取完整说明。
| 渠道 | 稳定性 | 使用方法 |
|---|---|---|
| 稳定版 | 生产就绪，仅修复补丁 | 添加 -c constraints-stable.txt |
| 测试版 | 新功能，经过良好测试 | 添加 -c constraints-testing.txt |
| Alpha版 | 前沿版本，可能不稳定 | 添加 --pre |
OVOS 是模块化的 — 只安装你需要的服务：
| 服务 | 功能 |
|---|---|
| ovos-messagebus | 消息总线 — 连接所有服务的骨干 |
| ovos-core | 技能处理和意图处理 |
| ovos-dinkum-listener | 麦克风、唤醒词、语音转文本 |
| ovos-audio | 文本转语音和音频输出 |
| ovos-gui | 触摸屏和显示器的 GUI 支持 |
| ovos-PHAL | 硬件抽象层 (LED、按钮等) |
例如，一个 HiveMind 卫星节点只需要监听器 — 无需音频栈。
此仓库托管 约束文件 — 这些版本锁定文件确保所有 OVOS 包能够无冲突地一起安装。使用 OVOS 时，你无需克隆或理解此仓库；当你向 pip 传递 -c constraints-*.txt 时，它会自动使用。