开源项目安装与配置指南

开源项目安装与配置指南

meeting-minutes An open source Live Ai based meeting minutes generator that can completely run in your PC. 项目地址: https://gitcode.com/gh_mirrors/me/meeting-minutes

1. 项目基础介绍

本项目是一个开源的AI会议助手，它能够实时捕捉会议音频，并对其进行转录，同时生成会议纪要。该项目的目标是让团队成员可以专注于讨论，而无需手动记录会议内容。所有的处理都在本地设备上完成，保证了用户隐私。

主要编程语言：

• Python：后端开发
• JavaScript/TypeScript：前端开发
• Rust：音频捕获服务（实验性）

2. 项目使用的关键技术和框架

• 音频捕获服务：使用Rust语言开发的音频捕获服务，能够捕捉麦克风和系统音频。
• 转录引擎：使用Whisper.cpp进行本地音频转录，支持多种模型大小。
• LLM（大型语言模型）编排器：提供了一个统一的接口，用于调用多个LLM提供者。
• 数据服务：使用ChromaDB作为向量存储，SQLite用于进程跟踪和元数据存储。
• 前端：使用了Tauri框架和Next.js构建跨平台的应用程序。
• 后端：基于Python的FastAPI框架，提供API服务。

3. 项目安装和配置的准备工作与详细步骤

准备工作

• 确保安装了以下依赖：
  • Node.js 18+（用于前端开发）
  • Python 3.10+（用于后端开发）
  • FFmpeg（用于音频处理）
  • Rust 1.65+（用于实验性功能）
  • Cmake 3.22+（用于构建前端）
  • 对于Windows用户：Visual Studio Build Tools（带C++开发工作负载）

安装步骤

前端安装

1. 访问项目的发布页下载最新的前端版本。
2. 根据操作系统选择合适的安装程序：
   • Windows：下载.exe或.msi安装程序，按提示完成安装。
   • macOS：下载dmg文件，解压后双击安装，然后拖动应用到应用程序文件夹中。在终端执行以下命令移除 quarantine 属性：

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

   • 给应用必要的权限以访问麦克风和音频。

后端安装

1. 克隆项目仓库到本地：

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

2. 创建并激活虚拟环境：
   • macOS/Linux：

     python -m venv venv
     source venv/bin/activate
     

   • Windows：

     python -m venv venv
     .\venv\Scripts\activate
     

3. 安装依赖：

   pip install -r requirements.txt
   

4. 创建环境文件并添加API密钥：
   • macOS/Linux：

     echo -e "ANTHROPIC_API_KEY=your_api_key\nGROQ_API_KEY=your_api_key" | tee .env
     

   • Windows (PowerShell)：

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

5. 配置环境变量（如果使用Groq）：
   • macOS/Linux：

     export GROQ_API_KEY=your_groq_api_key
     

   • Windows (PowerShell)：

     $env:GROQ_API_KEY="your_groq_api_key"
     

6. 构建依赖：
   • macOS/Linux：

     chmod +x build_whisper.sh
     ./build_whisper.sh
     

   • Windows：

     .\build_whisper.bat
     

7. 启动后端服务：
   • macOS/Linux：

     ./clean_start_backend.sh
     

   • Windows：

     .\start_with_output.ps1
     

按照以上步骤，您可以成功安装并配置本项目。在安装过程中，请确保遵循所有的指示，并在需要时提供必要的权限。

meeting-minutes An open source Live Ai based meeting minutes generator that can completely run in your PC. 项目地址: https://gitcode.com/gh_mirrors/me/meeting-minutes