amicalhq/amical

Amical – 本地优先的 AI 语音转录

是什么 – Amical 是一个开源桌面应用程序，可在您自己的机器上使用 AI 进行语音输入和笔记记录。它结合了 OpenAI 的 Whisper 用于语音转文字，并通过 Ollama 运行本地大语言模型（LLM），以理解上下文并为当前使用的应用程序（邮件、IDE、聊天等）生成格式化的转录内容。无需互联网连接，您的语音数据永远不会离开设备。

主要功能

• 快速准确的语音输入 – Whisper 本地运行，实现近乎实时的转录。
• 上下文感知的格式化 – 应用程序检测当前活动窗口，并自动调整输出格式（例如邮件格式、代码片段、聊天消息）。
• 可扩展的工作流 – 支持添加快捷键、语音宏和自定义处理管道。
• 隐私优先 – 所有模型均在本地下载并执行，应用不会将音频发送到云端。
• 浮动小部件 – 小型屏幕控制组件，无需中断工作流即可开始/停止录音。
• 计划中 – 语音笔记摘要、任务提取、会议转录以及更深入的应用程序控制集成。

技术栈

• 语音转文字：Whisper（编译为原生插件）
• LLM 推理：Ollama（在本地运行开源模型）
• 桌面框架：Electron + TypeScript
• UI：TailwindCSS + Shadcn UI 组件
• 认证与验证：Better-Auth, Zod
• 构建与测试：Turborepo, Vitest, TypeScript 7（原生编译器）

开发环境设置

1. 克隆并包含子模块 – git clone --recurse-submodules https://github.com/amicalhq/amical.git
2. 安装工具 – Node 24、pnpm 10.15、CMake ≥ 3.20，macOS 需 Xcode，Windows 需 Visual Studio 2022。
3. 启用 Corepack 并安装依赖 – corepack enable && pnpm install --frozen-lockfile
4. 下载 Whisper 使用的 Node 二进制文件 – pnpm --filter @amical/desktop download-node
5. 运行应用 – pnpm turbo run dev --filter=@amical/desktop
6. 提交 PR 前运行检查 – pnpm type:check && pnpm test

终端用户安装方式

• macOS：brew install --cask amical 或从最新发布版下载。
• Windows：从发布页面下载安装程序。
• Android：可通过 Google Play 获取（README 中链接）。
• iOS：提供 Beta 注册链接。

贡献说明 – 项目欢迎 PR 和错误报告。讨论与社区支持在 Discord 服务器中进行。提交 PR 前请遵循贡献检查清单（运行类型检查和测试）。

许可证 – MIT。