Meeting：本地实时转录和生成会议纪要的开源客户端

综合介绍

Meeting Minutes（又名 Meetily）是由 Zackriya Solutions 开发的一款免费开源的 AI 会议助手工具，专注于实时捕获会议音频、生成转录文本并自动提取会议摘要。该工具完全在本地设备上运行，支持 macOS 和 Windows 系统（Linux 支持开发中），无需外部服务器，确保用户数据的隐私安全。它兼容 Google Meet、Zoom 和 Microsoft Teams 等主流会议平台，内置 Whisper.cpp 转录引擎和多种大型语言模型（LLM）支持，适合团队协作和需要保护敏感信息的专业用户。截至 2025 年 3 月，最新版本为 v0.0.3 预发布，已在 GitHub 上获得 1000+ 星标，采用 MIT 许可。

功能列表

• 实时音频捕获：支持从麦克风和系统音频捕获会议内容，适用于多种会议平台。
• 实时转录：通过本地运行的 Whisper.cpp 模型将音频转换为文本，支持多种模型大小（tiny 到 large）。
• 自动摘要生成：利用 LLM（如 Anthropic、Groq 或本地 Ollama 模型）分析转录内容，提取关键要点、行动项和决策。
• 本地处理：所有数据处理在用户设备上完成，无需联网，保障隐私。
• 语义搜索：通过 ChromaDB 向量存储和知识图谱支持历史会议内容的智能检索。
• 跨平台支持：提供 macOS 和 Windows 的打包应用，Linux 支持即将推出。
• 导出功能（开发中）：支持将转录和摘要导出为 Markdown、PDF 和 HTML 格式。
• 现代化界面：提供响应式 UI，实时更新转录和摘要内容。

使用帮助

安装流程

Meeting Minutes 是一款自托管工具，用户需在本地设备上完成前端和后端的安装。以下是基于 v0.0.3 预发布版的详细步骤：

前置条件

• 操作系统：macOS 或 Windows（Linux 支持开发中）。
• 软件依赖：
  • 前端：无需额外依赖，直接使用预编译安装包。
  • 后端：
    • Python 3.10 至 3.12。
    • FFmpeg（音频处理）。
    • CMake 和 C++ 编译器（构建 Whisper.cpp）。
    • Windows 用户需安装 Visual Studio Build Tools（含 C++ 开发工作负载）。
• 硬件要求：建议 8GB 以上内存，多核处理器，支持 GPU 加速可提升性能。

安装步骤

1. 前端安装

前端提供预编译的安装包，支持 Windows 和 macOS，直接下载并安装即可。

Windows 安装

• 下载安装包：访问 v0.0.3 Releases 页面，选择以下任一文件：
  • 选项 1（推荐）：meeting-minutes-frontend_0.1.0_x64-setup.exe。
  • 选项 2：meeting-minutes-frontend_0.1.0_x64_en-US.msi。
• 运行安装程序：
  1. 双击下载的 .exe 或 .msi 文件。
  2. Windows 会弹出“Windows 保护您的电脑”提示，显示“Microsoft Defender SmartScreen 阻止了未识别的应用”：
     • 点击“更多信息”。
     • 选择“仍要运行”。
  3. 若仍无法运行，可右键点击安装文件：
     • 选择“属性”。
     • 在底部勾选“解除锁定”复选框，点击“确定”。
  4. 按照安装向导完成安装，应用将出现在桌面。
• 授予权限：首次运行时，允许麦克风和音频捕获权限。

macOS 安装

• 下载安装包：从 v0.0.3 Releases 页面 下载 dmg_darwin_arch64.zip。
• 安装步骤：
  1. 解压 dmg_darwin_arch64.zip，得到 meeting-minutes-frontend_0.1.0_aarch64.dmg。
  2. 双击 .dmg 文件。
  3. 将 meeting-minutes-frontend.app 拖入 Applications 文件夹。
  4. 在终端运行以下命令移除隔离属性：

     xattr -c /Applications/meeting-minutes-frontend.app
     

• 授予权限：首次运行时，允许麦克风和音频捕获权限。

2. 后端安装

后端需手动部署，以下为完整步骤：

1. 克隆仓库

git clone https://github.com/Zackriya-Solutions/meeting-minutes.git
cd meeting-minutes/backend

2. 安装前置依赖

• macOS：
  • 通过 Homebrew 安装 FFmpeg：brew install ffmpeg。
  • 安装 CMake：brew install cmake。
• Windows：
  • 使用 Chocolatey 安装 FFmpeg：choco install ffmpeg。
  • 安装 Visual Studio Build Tools（含 C++ 工作负载）。
  • 确保 Python 3.10+ 已加入 PATH。

3. 配置环境变量（可选）
   若使用 Anthropic 或 Groq 的 LLM，需创建 .env 文件并添加 API 密钥：

• 获取密钥：
  • Anthropic：https://www.anthropic.com/。
  • Groq：https://console.groq.com/。
• 配置：
  • macOS：

    echo -e "ANTHROPIC_API_KEY=your_api_key\nGROQ_API_KEY=your_groq_api_key" > .env
    

  • Windows (PowerShell)：

    "ANTHROPIC_API_KEY=your_api_key`nGROQ_API_KEY=your_groq_api_key" | Out-File -FilePath .env -Encoding utf8
    

• 设置 Groq 环境变量：
  • macOS/Linux：

    export GROQ_API_KEY=your_groq_api_key
    

  • Windows (PowerShell)：

    $env:GROQ_API_KEY="your_groq_api_key"
    

  • Windows (命令提示符)：

    set GROQ_API_KEY=your_groq_api_key
    

4. 构建 Whisper.cpp

• macOS：

chmod +x build_whisper.sh
./build_whisper.sh

• Windows：

.\build_whisper.bat

（若脚本失败，可手动运行脚本内的命令）

5. 启动后端服务

• macOS：

./clean_start_backend.sh

• Windows：

.\start_with_output.ps1

使用方法

安装完成后，用户可通过以下步骤使用 Meeting Minutes：

1. 实时转录会议

• 启动应用：双击桌面上的前端应用，或运行后端服务。
• 选择音频源：在界面中选择“麦克风”或“系统音频”。
• 开始录音：点击“开始”按钮，实时转录将显示在界面上。
• 停止与保存：会议结束点击“停止”，转录内容自动保存至本地。

2. 生成会议摘要

• 配置 LLM：在设置中选择本地模型或外部服务（需 .env 配置）。建议使用 32B 参数以上模型。
• 生成摘要：转录完成后点击“生成摘要”，查看关键要点、行动项和决策。
• 保存结果：当前保存为本地文件，导出功能（Markdown/PDF）开发中。

3. 语义搜索

• 查看历史：点击“历史记录”查看已保存会议。
• 搜索内容：输入关键词，工具返回相关片段。
• 跳转查看：点击结果查看详情。

操作技巧

• 提升转录质量：使用清晰麦克风，选择 large 版 Whisper 模型。
• 优化性能：若硬件不足，可用 Groq API 加速。
• 兼容性：在会议软件中调整音频输入设备。

注意事项

• 已知问题：
• 小型 LLM（<32B 参数）摘要质量较低。
• 后端构建需 CMake 和 C++，初次配置较复杂。
• 支持：问题可通过 Discord 或 GitHub 反馈。