Pre Release 0.0.3: Added Windows Support
A new release is available!
What's New
- Windows Support: Fixed audio capture issues on Windows
- Improved Error Handling: Better error handling and logging for audio devices
- Enhanced Device Detection: More robust audio device detection across platforms
- Windows Installers: Added both .exe and .msi installers for Windows
- Transcription quality is improved
- Bug fixes and improvements for frontend
- Better backend app build process
- Improved documentation
What would be next?
- Database connection to save meeting minutes
- Improve summarization quality for smaller LLM models
- Add download options for meeting transcriptions
- Add download option for summary
Known issues
- Smaller LLMs can hallucinate, making summarization quality poor; Please use model above 32B parameter size
- Backend build process requires CMake, C++ compiler, etc. Making it harder to build
- Backend build process requires Python 3.10 or newer
- Frontend build process requires Node.js
How to Get Started
Frontend
Windows Installation
Once the installers are downloaded from the above links [## Files for test](## Files for test), double-click the executable file to run it.
Windows will ask if you want to run untrusted apps, click More info
and choose run anyway
Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.
[More info](about:blank#)
To bypass this warning in windows OS,
After downloading the installer
- Right click on installer(.exe)
- Select properties option.
- Click on checkbox to check Unblock at the bottom of Properties.
Windows frontend Installation
Option 1: Using the Setup Executable (.exe) (Recommended)
- Download the
meeting-minutes-frontend_0.1.0_x64-setup.exe
file - Double-click the installer to run it
- Follow the on-screen instructions to complete the installation
- The application will be available on your desktop
Option 2: Using the MSI Installer (.msi)
- Download the
meeting-minutes-frontend_0.1.0_x64_en-US.msi
file - Double-click the MSI file to run it
- Follow the installation wizard to complete the setup
- The application will be installed and available on your desktop
macOS full Installation
Option 1: Using Homebrew (Recommended)
macOS users can now enjoy a streamlined installation process with Homebrew:
# Install Meetily using Homebrew (macOS only)
brew tap zackriya-solutions/meetily
brew install --cask meetily
# Start the backend server with your preferred language
meetily-server --language en --model medium
🌐 Multi-Language Transcription Support
Our backend now supports transcription in over 90 languages! Specify your preferred language when starting the server:
# English (default)
meetily-server --language en --model medium
# Spanish
meetily-server --language es --model medium
# French
meetily-server --language fr --model medium
# German
meetily-server --language de --model medium
# Japanese
meetily-server --language ja --model medium
# Chinese
meetily-server --language zh --model medium
# Auto-detect language (may be less accurate)
meetily-server --language all --model medium
🔄 Model Selection for macOS
Choose from various Whisper models based on your needs:
# Download your preferred model
meetily-download-model medium
# Available options:
# - tiny (fastest, least accurate)
# - base (fast, moderate accuracy)
# - small (balanced performance)
# - medium (recommended for most users)
# - large-v3 (highest accuracy, requires more resources)
✨ Why Use Homebrew on macOS?
- Native macOS Experience: Integrates perfectly with your macOS workflow
- Simplified Installation: No more manual downloads or permissions issues
- Automatic Updates: Stay current with
brew upgrade
- Clean Removal: Uninstall completely with
brew uninstall
🚀 Getting Started on macOS
After installation:
- Start the backend server with your language preference:
meetily-server --language [your_language_code]
- Launch Meetily from your Applications folder
- Begin capturing and transcribing your meetings in your preferred language!
🔧 Advanced Configuration for macOS Users
Fine-tune your experience with additional parameters:
# Set logging level
meetily-server --language en --model medium --log-level debug
# Specify custom model path (if you've downloaded models elsewhere)
meetily-server --language en --model /path/to/your/model.bin
Note : This step installs the backend server and the frontend app.
Once the backend and the frontend are started, you can open the application from the Applications folder.
Option 2: Manual Installation
- Download the dmg_darwin_arch64.zip zip file and extract to get
meeting-minutes-frontend_0.1.0_aarch64.dmg
file - Extract the file
- Double-click
meeting-minutes-frontend_0.1.0_aarch64.dmg
file inside the extracted folder - Drag the
meeting-minutes-frontend.app
to Applications folder - Execute the following command in terminal to remove the quarantine attribute:
xattr -c /Applications/meeting-minutes-frontend.app
Backend
-- For Mac OS only
Brew Tap
brew tap zackriya-solutions/meetily
Brew install
brew install meetily-backend
Please add the anthropic or groq API key when asked.
To run the backend, first choose a model.
Available models: tiny, base, small, medium, large-v3
meetily-download-model medium
To run the backend
meetily-server
This should start the backend on Mac OS
You can set up API keys during installation or manually:
echo "ANTHROPIC_API_KEY=your_key_here" > $(brew --prefix)/opt/meetily-backend/backend/.env
echo "GROQ_API_KEY=your_key_here" >> $(brew --prefix)/opt/meetily-backend/backend/.env
Installing backend in Windows
- Clone the repository:
git clone https://github.com/Zackriya-Solutions/meeting-minutes
-
Go to the
backend
directory: -
Make sure you have installed all the prerequisites before proceeding:
- ffmpeg
- cmake
- C++ compiler
- Python versions between 3.10 and 3.12
Windows-specific prerequisites:
- Install Visual Studio Build Tools with C++ development workload
- Install ffmpeg using Chocolatey:
choco install ffmpeg
- Ensure Python 3.10+ is in your PATH
-
Add environment file:
# On Windows (PowerShell):
"ANTHROPIC_API_KEY=your_api_key`nGROQ_API_KEY=your_api_key" | Out-File -FilePath .env -Encoding utf8
-
Add API Keys in .env files if you are planning to use Anthropic or Groq.
- For Anthropic: Sign up at https://www.anthropic.com/ and get your API key
- For Groq: Sign up at https://console.groq.com/ and get your API key from the API Keys section
-
Configure environment variables for Groq:
# On Windows (PowerShell):
$env:GROQ_API_KEY="your_groq_api_key"
# On Windows (Command Prompt):
set GROQ_API_KEY=your_groq_api_key
-
Build dependencies:
- On Windows:
.\build_whisper.bat
(or run the commands from the script manually)
- On Windows:
-
Run the server:
- On Windows:
.\start_with_output.ps1
- On Windows:
What's Changed
- Windows audio capture support
- Cross-platform audio device detection improvements
- Enhanced error handling and logging
- Windows installer packages (.exe and .msi)
- Various bug fixes and stability improvements
Introducing subscription
We are planning to add a subscription option so that you don't have to run the backend on your own server. This will help you scale better and run the service 24/7. This is based on a few requests we received. If you are interested, please fill out the form here.
Full Changelog: v0.0.2...v0.0.3
What's Changed
- Optimize/main by @sujithatzackriya in #13
- BugFixes by @sujithatzackriya in #14
- Devtest by @sujithatzackriya in #15
- Update README with optimized demo GIF by @sujithatzackriya in #16
- Devtest to main by @sujithatzackriya in #17
- Hot fix: Removed old images and added new ones by @sujithatzackriya in #18
- Bug Fix : Install issues by @sujithatzackriya in #19
- Bug Fix: Fixed the microphone audio capture issue by @sujithatzackriya in #31
- Devtest to main after Optimize Audio Recording Player Performance by @sujithatzackriya in #40
- Windows OS Support addition Devtest update by @sujithatzackriya in #45
Full Changelog: v0.0.2...v0.0.3