Dragonfire

环境要求

• Debian 或 Ubuntu 桌面 Linux 系统（服务器方式需要 Docker）
• 具有 sudo 权限的账号
• 磁盘需预留约 1.31GB 空间用于下载 Mozilla DeepSpeech 英文模型
• 需要麦克风才能使用语音唤醒与语音输入功能

安装与启动步骤

1. 1确认系统环境

   Dragonfire 面向 Ubuntu 等基于 Debian 的 Linux 发行版桌面环境，先确认系统与 sudo 权限，服务器场景可直接看第 5 步 Docker 方式。

2. 2安装 deb 安装包

   从 GitHub Releases 下载最新 .deb 文件到本地后，在文件所在目录执行安装。README 中的示例版本为 1.1.1_amd64。

   sudo dpkg -i dragonfire_1.1.1_amd64.deb

   复制

3. 3补全依赖

   dpkg 安装后立即执行此命令自动补齐依赖。安装过程会自动下载约 1.31GB 的 DeepSpeech 英文预训练模型。

   sudo apt-get -f install

   复制

4. 4源码方式安装

   不使用 deb 包时，克隆仓库并在仓库目录内执行 make install。注意必须在仓库目录下运行。

   git clone https://github.com/DragonComputer/Dragonfire.git
   cd Dragonfire
   sudo make install

   复制

5. 5Docker 方式部署

   服务器场景可改用 Docker 镜像，该镜像不含体积巨大的 DeepSpeech 模型，因此不具备语音识别能力。

   docker pull dragoncomputer/dragonfire

   复制

6. 6启动与参数选择

   本地可直接运行 dragonfire，也可从 Linux 应用启动器启动；Docker 用 docker run。常用参数 -c 键盘输入、-s 静音、-j 不显示头像、-g 改用谷歌语音识别。

   dragonfire
   dragonfire -c
   dragonfire --version
   docker run dragoncomputer/dragonfire

   复制

7. 7语音口令控制

   对着麦克风说 DRAGONFIRE、HEY 或 WAKE UP 唤醒；说 GO TO SLEEP 进入休眠；说 ENOUGH 或 SHUT UP 静音；说 GOODBYE 等结束程序。

关键配置

如何确认成功

执行 dragonfire --version 能打印出版本号即说明安装成功；正常启动后说出 DRAGONFIRE 能唤醒助手。

常见问题

注意事项

• Docker 镜像不安装 DeepSpeech 语音识别模型，因此无法进行语音识别。
• 自动下载的 DeepSpeech 英文模型会放在 /usr/share/dragonfire/deepspeech/models 目录下。
• 遇到安装或运行问题可查阅仓库的 docs/TROUBLESHOOTING.md。
• 项目当前维护活跃度一般，社区规模较小，安装前请留意最新 release 的版本号。