本地开发需用 --recurse-submodules 克隆以获取 Whisper 源码，否则要手动初始化子模块；pnpm install 会编译原生 Whisper 插件，耗时数分钟；运行开发版前需先退出已安装的 Amical，Electron 只允许单实例；首次启动引导会下载本地模型并申请麦克风与系统权限。
amical
amicalhqMIT活跃维护开源本地优先的 AI 语音听写应用，用开源模型离线转写，不用键盘就能快速输入文字，适合记笔记和会议记录。
🎙️ AI Dictation App - Open Source and Local-first ⚡ Type 3x faster, no keyboard needed. 🆓 Powered by open source models, works offline, fast and accurate.
v1.13.0发布于 2026-11-07 22:12 UTC1,604star +4 / 7 天144fork同步于 2026-11-10 17:49 UTC
brew install --cask amical 硬件要求按 README 说明
README 未说明显存或 GPU 型号要求；本地 Whisper 转写要求 macOS 15 或更高版本，桌面端仅支持 macOS 和 Windows，不支持 Linux。
本地优先的开源 AI 听写应用，用 Whisper 把语音转成文字并智能排版
开源本地优先的 AI 语音听写应用，用开源模型离线转写，不用键盘就能快速输入文字，适合记笔记和会议记录。
核心能力
- 用 Whisper 做本地语音转文字，离线可用
- 按当前活跃应用自动调整听写格式
- 用开源 LLM 对转写结果做智能处理
- 浮动小组件配合自定义热键启停听写
- 支持热键、语音宏和自定义工作流扩展
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v1.13.0Amical Desktop v1.13.0最新正式版2026-11-07 · 2026-11-07 22:12 UTC
Amical Desktop v1.13.0
Features
- desktop: raise dictation limit to 15 minutes (01959ec)
- desktop: add a QR code to get the mobile apps (e978bc0)
- desktop: ask signed-out users for a GitHub star (55ab4e3)
- desktop: read the billing offers from /me/usage (99993be)
- desktop: ask for telemetry consent and turn it on at sign-in (08b64e4)
- desktop: open billing from the cap toast signed in (73a09db)
- desktop: report how much the user edits a pasted dictation (b54c51c)
- desktop: add app type, language and formatting model to the dictation trace (e989528)
- desktop: show the usage reset as a relative time (f205462)
- desktop: put the sidebar help links in one icon row (0c69a81)
- desktop: show the cloud word allowance in the sidebar (466311e)
- types: add the cloud usage response contract (463ac1e)
- desktop: show learned words in vocabulary settings (3167f36)
- desktop: learn vocabulary from corrections after a paste (536d5b7)
- desktop: mark learned vocabulary rows and order hints (46c4735)
- desktop: track edits after a paste and extract correction candidates (48f0c33)
- desktop: add edit watch calls to the native bridge (409c3ce)
- windows-helper: hold and read the pasted-into text field (2e3dc64)
- swift-helper: hold and read the pasted-into text field (5bd66b1)
- types: add edit watch RPCs and the vocabulary term check contract (ea4b99f)
- desktop: mark cloud-only language variants in the picker (14c7e70)
- desktop: default new installs to the OS regional language variant (966d23f)
- desktop: lock the HTTP dictation language after the first chunk (5ec74e0)
- desktop: add regional variants and Cantonese to the language picker (5fd488e)
- desktop: store the gRPC session language as the detected language (c0df5c8)
- desktop: add regional variants and Cantonese to the dictation proto (001b699)
Bug Fixes
- desktop: translate the account and sign-out UI (fb713cb)
- desktop: tell Windows users to turn on each Amical mic entry (df90c93)
- desktop: warn on the usage meter from 80% used (6f3103e)
- desktop: open the mic on Windows to get mic access in setup (ef7d4a7)
- desktop: open the page directly when a web-session handoff fails (9487a8b)
- desktop: treat a fully replaced dictation as a rewrite and cap terms at two words (d4850bf)
- desktop: learn nothing after the user deletes a dictation (9b88fd0)
- desktop: keep the usage meter reading after plan changes (51a07a8)
- desktop: lift the auth event listener limit (14f8d9a)
- desktop: dim only the cloud row that is opening (2a7ad5e)
Other Changes
- use shared API contracts for cloud requests (db7e807)
- share the account fetch and page visibility hook (1d86818)
- match iOS download badge size (3f24a7a)
- update iOS download badge and link (1693364)
Downloads
macOS
- Apple Silicon (M1/M2/M3): Download the DMG or ZIP file for arm64
- Intel: Download the DMG or ZIP file for x64
Windows
- Windows (x64): Download the .exe installer for 64-bit Windows
- Windows (ARM64): Download the ARM64 .exe installer for Windows on Arm
Installation
macOS:
- DMG: Download and open the DMG file, then drag Amical to your Applications folder
- ZIP: Download and extract the ZIP file, then drag Amical to your Applications folder
Windows:
- Download and run the .exe installer
- Follow the installation wizard
- The app will be installed to your user AppData folder and a shortcut will be created
The ZIP files are primarily for automatic updates. We recommend using the DMG files for initial installation on macOS.
- v1.13.0-beta.2Amical Desktop v1.13.0-beta.2pre-release2026-11-06 · 2026-11-06 15:28 UTC
查看更新说明
Amical Desktop v1.13.0-beta.2
Features
- desktop: add a QR code to get the mobile apps (e978bc0)
- desktop: ask signed-out users for a GitHub star (55ab4e3)
- desktop: read the billing offers from /me/usage (99993be)
- desktop: ask for telemetry consent and turn it on at sign-in (08b64e4)
- desktop: open billing from the cap toast signed in (73a09db)
- desktop: report how much the user edits a pasted dictation (b54c51c)
- desktop: add app type, language and formatting model to the dictation trace (e989528)
- desktop: show the usage reset as a relative time (f205462)
- desktop: put the sidebar help links in one icon row (0c69a81)
- desktop: show the cloud word allowance in the sidebar (466311e)
- types: add the cloud usage response contract (463ac1e)
Bug Fixes
- desktop: translate the account and sign-out UI (fb713cb)
- desktop: tell Windows users to turn on each Amical mic entry (df90c93)
- desktop: warn on the usage meter from 80% used (6f3103e)
- desktop: open the mic on Windows to get mic access in setup (ef7d4a7)
- desktop: open the page directly when a web-session handoff fails (9487a8b)
- desktop: treat a fully replaced dictation as a rewrite and cap terms at two words (d4850bf)
- desktop: learn nothing after the user deletes a dictation (9b88fd0)
- desktop: keep the usage meter reading after plan changes (51a07a8)
- desktop: lift the auth event listener limit (14f8d9a)
- desktop: dim only the cloud row that is opening (2a7ad5e)
Other Changes
- use shared API contracts for cloud requests (db7e807)
- share the account fetch and page visibility hook (1d86818)
- match iOS download badge size (3f24a7a)
- update iOS download badge and link (1693364)
Downloads
macOS
- Apple Silicon (M1/M2/M3): Download the DMG or ZIP file for arm64
- Intel: Download the DMG or ZIP file for x64
Windows
- Windows (x64): Download the .exe installer for 64-bit Windows
- Windows (ARM64): Download the ARM64 .exe installer for Windows on Arm
Installation
macOS:
- DMG: Download and open the DMG file, then drag Amical to your Applications folder
- ZIP: Download and extract the ZIP file, then drag Amical to your Applications folder
Windows:
- Download and run the .exe installer
- Follow the installation wizard
- The app will be installed to your user AppData folder and a shortcut will be created
The ZIP files are primarily for automatic updates. We recommend using the DMG files for initial installation on macOS.
- v1.13.0-beta.1Amical Desktop v1.13.0-beta.1pre-release2026-10-26 · 2026-10-26 18:36 UTC
查看更新说明
Amical Desktop v1.13.0-beta.1
Features
- desktop: show learned words in vocabulary settings (3167f36)
- desktop: learn vocabulary from corrections after a paste (536d5b7)
- desktop: mark learned vocabulary rows and order hints (46c4735)
- desktop: track edits after a paste and extract correction candidates (48f0c33)
- desktop: add edit watch calls to the native bridge (409c3ce)
- windows-helper: hold and read the pasted-into text field (2e3dc64)
- swift-helper: hold and read the pasted-into text field (5bd66b1)
- types: add edit watch RPCs and the vocabulary term check contract (ea4b99f)
- desktop: mark cloud-only language variants in the picker (14c7e70)
- desktop: default new installs to the OS regional language variant (966d23f)
- desktop: lock the HTTP dictation language after the first chunk (5ec74e0)
- desktop: add regional variants and Cantonese to the language picker (5fd488e)
- desktop: store the gRPC session language as the detected language (c0df5c8)
- desktop: add regional variants and Cantonese to the dictation proto (001b699)
Downloads
macOS
- Apple Silicon (M1/M2/M3): Download the DMG or ZIP file for arm64
- Intel: Download the DMG or ZIP file for x64
Windows
- Windows (x64): Download the .exe installer for 64-bit Windows
- Windows (ARM64): Download the ARM64 .exe installer for Windows on Arm
Installation
macOS:
- DMG: Download and open the DMG file, then drag Amical to your Applications folder
- ZIP: Download and extract the ZIP file, then drag Amical to your Applications folder
Windows:
- Download and run the .exe installer
- Follow the installation wizard
- The app will be installed to your user AppData folder and a shortcut will be created
The ZIP files are primarily for automatic updates. We recommend using the DMG files for initial installation on macOS.
- v1.12.7Amical Desktop v1.12.7pre-release2026-10-13 · 2026-10-13 08:23 UTC
查看更新说明
Amical Desktop v1.12.7
Other Changes
- install Vulkan SDK 1.4.363.0 with the LunarG installer (ace63a7)
Downloads
macOS
- Apple Silicon (M1/M2/M3): Download the DMG or ZIP file for arm64
- Intel: Download the DMG or ZIP file for x64
Windows
- Windows (x64): Download the .exe installer for 64-bit Windows
- Windows (ARM64): Download the ARM64 .exe installer for Windows on Arm
Installation
macOS:
- DMG: Download and open the DMG file, then drag Amical to your Applications folder
- ZIP: Download and extract the ZIP file, then drag Amical to your Applications folder
Windows:
- Download and run the .exe installer
- Follow the installation wizard
- The app will be installed to your user AppData folder and a shortcut will be created
The ZIP files are primarily for automatic updates. We recommend using the DMG files for initial installation on macOS.
- v1.12.5Amical Desktop v1.12.52026-09-25 · 2026-09-25 13:14 UTC
查看更新说明
Amical Desktop v1.12.5
Bug Fixes
- ci: build windows arm64 with VS 2026 (d3fba9b)
Other Changes
- build the windows x64 vulkan variant in CI (cbc5b66)
- build windows x64 with VS 2026 (a9be27d)
Downloads
macOS
- Apple Silicon (M1/M2/M3): Download the DMG or ZIP file for arm64
- Intel: Download the DMG or ZIP file for x64
Windows
- Windows (x64): Download the .exe installer for 64-bit Windows
- Windows (ARM64): Download the ARM64 .exe installer for Windows on Arm
Installation
macOS:
- DMG: Download and open the DMG file, then drag Amical to your Applications folder
- ZIP: Download and extract the ZIP file, then drag Amical to your Applications folder
Windows:
- Download and run the .exe installer
- Follow the installation wizard
- The app will be installed to your user AppData folder and a shortcut will be created
The ZIP files are primarily for automatic updates. We recommend using the DMG files for initial installation on macOS.
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
Table of Contents
⬇️ Download
Homebrew (macOS)
brew install --cask amical
🔮 Overview
Local-first AI Dictation app.
Amical is an open source AI-powered dictation and note-taking app that runs entirely on your machine. Powered by Whisper for speech-to-text and open source LLMs for intelligent processing, Amical gives you the power of AI dictation with complete privacy.
Context-aware dictation that adapts to what you're doing: drafting an email, chatting on Discord, writing prompts in your IDE, or messaging friends. Amical detects the active app and formats your speech accordingly.
✨ Features
✔︎ - Done, ◑ - In Progress, ◯ - Planned
🚀 Super-fast dictation with AI-enhanced accuracy ✔︎
🧠 Context-aware speech-to-text based on the active app ✔︎
📒 Smart voice notes → summaries, tasks, structured notes ◑
🔌 MCP integration → voice commands that control your apps ◯
🎙️ Real-time meeting transcription (mic + system audio) ◯
🔧 Extensible via hotkeys, voice macros, custom workflows ✔︎
🔐 Privacy-first: works offline, one click setup of local models in-app ✔︎
🪟 Floating widget for frictionless start/stop with custom hotkeys ✔︎
🔰 Tech Stack
- 🎤 Whisper
- 🦙 Ollama
- 🧑💻 Typescript
- 🖥️ Electron
- 🎨 TailwindCSS
- 🧑🏼🎨 Shadcn
- 🔒 Better-Auth
- 🧘♂️ Zod
- 🐞 Vitest
- 🌀 Turborepo
Local Development
These steps run the desktop app, which currently supports macOS and Windows. Linux is not supported because the app does not yet have a Linux native helper.
Prerequisites
- Node.js 24.x
- pnpm 10.15.0 (the version pinned in
package.json) - CMake 3.20 or later
- macOS: Xcode or the Xcode Command Line Tools with Swift 5.9 or later
(
xcode-select --install). Local Whisper transcription requires macOS 15 or later. - Windows: Visual Studio 2022 Build Tools with the Desktop development with C++ workload, plus the .NET 8 SDK. Git Bash is recommended because some development scripts use POSIX utilities.
Set up the repository
Clone with submodules so the Whisper sources are available:
git clone --recurse-submodules https://github.com/amicalhq/amical.git
cd amical
If you already cloned without --recurse-submodules, initialize them now:
git submodule update --init --recursive
Enable Corepack so it uses the pinned pnpm version, install dependencies, and download the Node.js binary used by the local Whisper worker:
corepack enable
pnpm install --frozen-lockfile
pnpm --filter @amical/desktop download-node
pnpm install compiles the native Whisper addon, so it can take a few minutes.
It also applies the repository's patches inside the whisper.cpp submodule.
Seeing that submodule marked as modified in git status afterward is expected.
Start the desktop app
Quit any installed copy of Amical first; Electron allows only one Amical instance at a time. Then run:
pnpm turbo run dev --filter=@amical/desktop
When finished, quit the development app from its tray menu and then press Ctrl+C. Stopping the terminal command alone may leave the Electron app running.
No .env file is required for local transcription. The first-run onboarding
downloads a local model and requests the required microphone and OS
permissions. Only configure apps/desktop/.env from
apps/desktop/.env.example when working on optional cloud, authentication, or
telemetry integrations, and replace its placeholder values before use.
Run checks
Workspace builds and typechecks use TypeScript 7.0.2. The @typescript/native
dependency is an alias for the native compiler and provides tsc. The
typescript dependency is an alias for Microsoft's TypeScript 6 compatibility
package, which provides the compiler API used by ESLint and other tools. This
follows Microsoft's side-by-side setup.
Run pnpm exec tsc --version to check the build compiler version.
For VS Code, install the recommended TypeScript 7 extension. The workspace settings point it at the same native compiler.
Before opening a pull request, run:
pnpm type:check
pnpm test
🤗 Contributing
Contributions are welcome! Reach out to the team in our Discord server to learn more.
- 🐛 Report an Issue: Found a bug? Let us know!
- 💬 Start a Discussion: Have ideas or suggestions? We'd love to hear from you.
- ⭐ Star Amical on GitHub: A star helps other people find Amical.
🎗 License
Released under MIT.
VoiceStudio
debpalash·Python
本地运行的 ElevenLabs 开源替代品，支持声音克隆、语音设计、视频配音、听写、转写和有声书制作，覆盖 646 种语言。
语音克隆+4语音推理
107004+388012kv0.5.72026-11-10 16:38 UTC
voicebox
jamiepine·Python
开源 AI 语音工作室，支持声音克隆、语音听写和语音生成，基于 Qwen3-TTS 与 Whisper，可在 CUDA 或 MLX 上本地运行。
语音克隆+4语音推理
60376+6237.6kv0.5.02026-10-07 01:17 UTC
whisper.cpp
ggml-org·C++
OpenAI Whisper 语音识别模型的 C/C++ 移植版，无需 Python 和 GPU 依赖，在普通 CPU 上就能跑语音转文字。
语音识别+4语音推理
55071+846.3kv1.9.52026-11-10 12:09 UTC
faster-whisper
SYSTRAN·Python
基于 CTranslate2 重实现的 Whisper 语音转文字推理引擎，通过量化与高效推理大幅提速并降低显存占用，适合本地部署转录。
语音识别+4语音推理
26650+782.2kv1.2.12026-11-10 10:13 UTC