安装¶

前置条件¶

Python 3.10 或更高版本

系统依赖¶

安装 asr2clip 之前，请确保以下系统依赖可用：

依赖	用途	Linux	macOS	Windows
ffmpeg	音频格式转换	`apt install ffmpeg`	`brew install ffmpeg`	下载
PortAudio	音频录制	`apt install libportaudio2`	`brew install portaudio`	随 sounddevice 安装
剪贴板	复制到剪贴板	内置 (copykitten)	内置	内置

Note

剪贴板功能由 copykitten 处理，它直接使用平台原生 API。在 Wayland 会话下，asr2clip 优先使用 wl-copy（来自 wl-clipboard）以正确集成剪贴板管理器（如 KDE Klipper）。如未安装，请运行 apt install wl-clipboard。在 X11、macOS 和 Windows 下无需任何外部工具。

使用 pip 或 pipx 安装（推荐）¶

# 使用 pip 安装
pip install asr2clip

# 或使用 pipx 安装（推荐用于隔离环境）
pipx install asr2clip

# 升级到最新版本
pip install --upgrade asr2clip

从源码安装¶

git clone https://github.com/Oaklight/asr2clip.git
cd asr2clip
pip install -e .

可选：本地 ASR 服务器¶

安装本地 ASR 服务器（基于 sherpa-onnx 的离线转录）：

pip install "asr2clip[local_asr]"

详情请参阅本地 ASR 服务器。