mirror of
https://github.com/hanzoai/minutes.git
synced 2026-10-30 18:27:58 +00:00
zeekayandHanzo Dev
ecd717c6fb
A fork of meetily (MIT, Zackriya Solutions) rebranded to Hanzo. The Python/FastAPI tier, its Docker files, its whisper-server scripts and the whisper.cpp submodule are deleted rather than rebranded. Upstream's own CLAUDE.md says that tier is archived and unsupported and tells you not to add endpoints to it; the shipping product is one Tauri binary that transcribes in-process with whisper-rs and Parakeet. Rebranding a corpse would have doubled the surface and taught the next reader that a dead service is a live one. Going with it: the vestigial localhost:5167 gate the sidebar checked before reading its own database. .github/workflows goes too. This repo lives on git.hanzo.ai, which reads .hanzo/workflows, and we do not use GitHub-hosted runners — six workflow files that cannot run read like CI that passes. Nothing replaces them yet, because a pipeline that has never run is worse than an honest absence. Summaries are written by api.hanzo.ai, our own stack, and it is the default. The other providers still compile and should go in a follow-up. The upstream MIT notice stays and the Hanzo copyright joins it. About and the README say plainly what this is a fork of. Left alone deliberately, and each is a decision someone must still make: the minisign updater key is upstream's and we cannot re-sign, so the updater points at a release path that does not exist yet; the ffmpeg binaries still come from upstream's GitHub; the Parakeet models still come from upstream's host. Co-authored-by: Hanzo Dev <[email protected]>
4.5 KiB
4.5 KiB
Minutes - Frontend
A modern desktop application for recording, transcribing, and analyzing meetings with AI assistance. Built with Next.js and Tauri for a native desktop experience.
Features
- Real-time audio recording from both microphone and system audio
- Live transcription using Whisper ASR (locally running)
- Native desktop integration using Tauri
- Speaker diarization support
- Rich text editor for note-taking
- Privacy-focused: All processing happens locally
Prerequisites
For macOS:
- Node.js (v18 or later)
- Rust (latest stable)
- pnpm (v8 or later)
- Xcode Command Line Tools
For Windows:
- Node.js (v18 or later)
- Rust (latest stable)
- pnpm (v8 or later)
- Visual Studio Build Tools with C++ development tools
- Windows 10 or later
Project Structure
/frontend
├── src/ # Next.js frontend code
├── src-tauri/ # Rust backend for Tauri
├── public/ # Static assets
└── package.json # Project dependencies
Installation
For macOS:
-
Install prerequisites:
# Install Homebrew if not already installed /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Install Node.js brew install node # Install Rust curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Install pnpm npm install -g pnpm # Install Xcode Command Line Tools xcode-select --install -
Clone the repository and navigate to the frontend directory:
git clone https://git.hanzo.ai/hanzoai/minutes cd meeting-minutes/frontend -
Install dependencies:
pnpm install
For Windows:
-
Install prerequisites:
- Install Node.js (v18 or later)
- Install Rust
- Install pnpm:
npm install -g pnpm - Install Visual Studio Build Tools with C++ development tools
-
Clone the repository and navigate to the frontend directory:
git clone https://git.hanzo.ai/hanzoai/minutes cd meeting-minutes/frontend -
Install dependencies:
pnpm install
Running the App
For macOS:
Use the provided script to run the app in development mode:
./clean_run.sh
To build a production version:
./clean_build.sh
You can specify the log level (info, debug, trace):
./clean_run.sh debug
For Windows:
Use the provided script to run the app in development mode:
clean_run_windows.bat
To build a production version:
clean_build_windows.bat
You can also use the package scripts directly:
pnpm run tauri:dev
pnpm run tauri:build
Local Transcription
Current Minutes does not require a separate FastAPI service, Docker backend, or manually started whisper-server process. Local transcription is handled by the Rust/Tauri desktop app.
For build and acceleration details, see:
Development
Frontend (Next.js)
- The frontend is built with Next.js and Tailwind CSS
- Source code is in the
src/directory - To run only the frontend:
pnpm run dev
Backend (Tauri)
- The Rust backend is in the
src-tauri/directory - Handles audio capture, file system access, transcription, storage, and native integrations
- To run only the Tauri development server:
pnpm run tauri:dev
Troubleshooting
Common Issues on macOS
- If you encounter permission issues with scripts, make them executable:
chmod +x clean_run.sh clean_build.sh - For microphone access issues, ensure the app has microphone permissions in System Preferences
Common Issues on Windows
- If you encounter build errors, ensure Visual Studio Build Tools are properly installed
- For audio capture issues, check Windows privacy settings for microphone access
- If the app fails to start, try running Command Prompt as administrator
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.