amical

动嘴不动手，本地 AI 听写让你打字快 3 倍

amical 是一款本地优先的开源 AI 听写应用，旨在让用户摆脱键盘，通过语音实现 3 倍速的文字输入。它基于 Electron 和 Next.js 构建，支持 macOS 等平台，核心能力是调用本地或远程的 ASR（自动语音识别）模型（如通过 Ollama 集成）进行实时语音转文字，并具备 AI 润色和笔记整理功能。项目解决了传统听写工具依赖云端、延迟高、隐私泄露的问题，所有音频处理可在本地完成，离线也能使用。它面向需要快速记录、会议纪要、内容创作等场景，提供了简洁的界面和 MCP 支持，方便与外部工具集成。目前项目处于成长阶段，社区活跃，适合开发者定制和二次开发。

开源 unknown 语音识别

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1540

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类语音识别

开发团队amicalhq

所属国家

官网地址https://amical.ai

GitHubhttps://github.com/amicalhq/amical

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-note-taking-app,asr,dictate,dictation,dictation-tool,electron,local-ai,macos,mcp,meeting-notes,nextjs,ollama,productivity,self-hosted,speech-to-text,transcription,whisper,windows

GitHub 星标★ 1540

30天Star增速

HF 下载量

上线时间2025-05-08 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数6

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

macOS 系统（Homebrew 安装方式，需已安装 Homebrew）
Git（克隆仓库并拉取子模块）
Node.js 与 Corepack（本地开发需要，README 要求启用 Corepack 以使用固定版本 pnpm）
pnpm（通过 Corepack 启用，无需单独全局安装）

安装与启动步骤

1Homebrew 安装

macOS 用户可直接用 Homebrew 的 cask 方式安装，安装完成后在启动台或应用程序目录找到 Amical。
```
brew install --cask amical
```
2或下载安装包

非 macOS 或不想用 Homebrew，可打开 GitHub Releases 页面下载对应平台安装包（README 还提供 Android 与 Beta 入口）。
3克隆仓库

二次开发或本地运行源码时使用，务必带 --recurse-submodules，否则缺少 Whisper 源码。
```
git clone --recurse-submodules https://github.com/amicalhq/amical.git
```
4补全子模块

如果克隆时忘记加 --recurse-submodules，进入仓库后执行此命令初始化并拉取全部子模块。
```
cd amical
git submodule update --init --recursive
```
5启用 Corepack 并装依赖

Corepack 会使用仓库固定的 pnpm 版本；pnpm install 会编译 Whisper 原生插件，可能耗时几分钟。
```
corepack enable
pnpm install --frozen-lockfile
```
6下载 Node 二进制

下载本地 Whisper worker 所使用的 Node.js 二进制文件，缺少它本地转录无法运行。
```
pnpm --filter @amical/desktop download-node
```
7运行检查

提交 PR 前执行类型检查与测试，确认本地开发环境搭建正确、代码无回归。
```
pnpm type:check
pnpm test
```

如何确认成功

Homebrew 安装后能在应用程序中打开 Amical；源码方式下 pnpm type:check 与 pnpm test 均全部通过，无报错。

常见问题

Q：克隆后 git status 显示 whisper.cpp 子模块被修改，正常吗？

A：正常。README 明确说明 pnpm install 会在 whisper.cpp 子模块内应用仓库补丁，子模块显示 modified 是预期现象。

Q：pnpm install 特别慢甚至卡住？

A：因为该命令会编译 Whisper 原生插件，README 提示可能需要几分钟，耐心等待即可，不要中途中断。

Q：克隆时忘了加 --recurse-submodules 怎么办？

A：在仓库根目录执行 git submodule update --init --recursive 即可补回所有子模块，无需重新克隆。

Q：我不是 macOS，怎么安装？

A：README 的 Homebrew 命令仅针对 macOS，其他平台请从 GitHub Releases 最新版本页面下载对应安装包。

注意事项

README 未给出源码方式的启动命令，本教程只覆盖官方提供的安装、克隆、依赖安装与检查步骤。
Amical 为本地优先应用，音频处理可在本机完成，离线也能使用。
提交 PR 前务必先跑 pnpm type:check 和 pnpm test。

核心亮点

本地优先，离线可用，保护隐私，不依赖云端
集成 Ollama 等开源模型，支持自定义 ASR 引擎
提供 MCP 接口，可扩展连接其他 AI 工具

不足之处

文档/社区待观察
依赖 Electron，内存占用可能偏高

适用场景

会议记录与整理，快速生成纪要
写作初稿口述，提高文字输入效率
无障碍场景，替代键盘输入

替代项目

Whisper、Superwhisper、MacWhisper

项目介绍

amical 是语音识别领域的开源项目，由 amicalhq 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,540）位列前 30%，在语音识别分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,484 增加到 1,540，净增 56。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：会议记录与整理，快速生成纪要。同类可对比的替代方案包括 Whisper、Superwhisper、MacWhisper。

上一篇：transcribe.cpp

下一篇：CrisperWhisper