[ COE INSTALL // QUICK START ]

安装 Coe

先准备 Linux 依赖,再运行官方安装脚本,然后开始听写。

1. 安装依赖

Ubuntu:

sudo apt update
sudo apt install -y fcitx5 pipewire-bin wl-clipboard ydotool

这些依赖提供录音、回写文本,以及通过 Fcitx 接入 Linux 桌面环境的能力。

2. 安装 Coe

使用官方 release 安装脚本。

curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/coe/refs/heads/master/scripts/install.sh
bash /tmp/install.sh

安装脚本会自动判断集成路径。如果系统里已经有 fcitx5,会优先走 Fcitx;否则会回退到 GNOME 桌面路径。

如果你要强制指定:

bash /tmp/install.sh --fcitx
bash /tmp/install.sh --gnome

如果最终走的是 GNOME 桌面路径,建议注销并重新登录一次。

3. 配置 Provider

把 Provider key 写进以下任意一个位置:

  • ~/.config/coe/env
  • ~/.config/coe/config.yaml

初始化 YAML 配置:

coe config init

Coe 可以接你自己的 ASR,也可以接你自己的 LM / LLM,因此语音和文本整理链路都可以放在你自己掌控的栈里。

4. 第一次听写

打开任意一个文本输入框,按默认热键 Shift + Super + D,开始说话,再按一次停止。

5. 参考