Kumbuka — Local meeting recording and transcription for…

Pitch

Description

Comments

About this project

Kumbuka is a macOS application that records meetings, transcribes them using Whisper, and generates organized notes with Claude. With features like speaker attribution and auto-saving to Notion, Kumbuka offers a powerful yet cost-effective solution for efficient meeting management, all running locally on your Mac.

Kumbuka is a powerful macOS application designed for seamless meeting management, allowing users to record meetings, transcribe audio locally with Whisper, and generate concise notes using Claude. This efficient tool replicates the functionality of Notion's enterprise meeting recording feature without the associated costs, enabling users to maintain productivity without the need for an enterprise subscription.

Key Features

Auto-generated Titles and Participant Identification: Effortlessly keep track of attendees with automatic identification during meetings.
Extraction of Key Insights: Automatically extracts summaries, decisions, and action items for easy reference post-meeting.
Speaker-Attributed Transcript: Generate detailed transcripts that indicate who said what, enhancing clarity.
Optional Notion Export: Save meeting notes directly to Notion for organized access, if desired.

System Requirements

Exclusively for macOS environments.
Requires macOS 12+ (Apple Silicon is recommended).
Must have Python 3.10+ installed for script management.
uv needed as a Python package manager.
Command-Line interface access to Claude Code.
Setup of a local Whisper server, such as VoiceMode.
An optional Notion account for exporting notes.

Permissions Management

To function correctly, Kumbuka requires specific permissions through the System Settings in macOS:

Permission	Purpose	Triggered When
Microphone	To record audio	Upon first launch of `kumbuka`
Calendar Access (Automation)	To read upcoming meetings	When the calendar monitoring feature activates
Terminal Access (Automation)	To open Terminal for recording	When the record prompt is activated

Ease of Use

Getting started is simple:

kumbuka
# Press Ctrl+C to stop recording.

Automated Meeting Monitoring

Kumbuka can monitor calendar events and notify users two minutes before a meeting starts, providing the option to begin recording immediately. This is accomplished through a LaunchAgent that executes every 60 seconds, querying Calendar.app for upcoming meetings, ensuring that no important discussions are missed.

Configuration Options

Users can customize preferences such as:

Which calendars to monitor
How many minutes prior to a meeting the prompt appears

Project Structure

Kumbuka features a well-organized directory structure for easy navigation and customization, allowing users to tweak components, such as meeting prompts, based on personal preferences.

Troubleshooting Support

Kumbuka provides a troubleshooting guide to assist users in resolving common issues like Whisper not running or audio recording problems, ensuring a smooth user experience.

For contributors wishing to enhance Kumbuka, detailed guidelines are available in the CONTRIBUTING.md document.