Meetily - 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://github.com/Zackriya-Solutions/meeting-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://github.com/Zackriya-Solutions/meeting-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 Meetily 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.