How Hapi works

Hapi runs as a menu-bar app on macOS 14+. There is no dock icon by default — open the main window from the menu-bar icon, or hit your record hotkey from anywhere. Settings live in a window with a sidebar of ten sections; everything below maps back to one of them.

First-launch checklist

1. Microphone access. Required for voice notes and meetings. macOS will prompt the first time you record.
2. Accessibility access. Required for the global hotkey and for auto-paste. macOS asks once; you may need to restart Hapi after granting it.
3. Screen Recording. Required to capture system audio from meeting apps and browsers. The first meeting you join triggers the prompt.
4. Calendar (optional). Lets Hapi link recordings to events and generate pre-meeting briefings.
5. Tell Hapi about you. In Settings → People → Your profile, add your name, email, role, and any context you want Hapi to use when it summarizes meetings or drafts follow-ups in your voice.

Where to find things

• Sidebar: Dashboard, Meetings, Voice Notes, Record, Settings.
• Bottom bar: persistent “Ask Hapi” chat. The scope follows the page you're on (Dashboard, a specific meeting, voice notes, or a person).
• Settings: ten sections — General, Voice Notes, Meetings, People, Plays, AI, Integrations, Automations, License, About.

Hold the global hotkey, speak, release. Words stream back in under two seconds. By default the result is copied to your clipboard and pasted into whatever app you were in.

Changing your hotkey

Open Settings → Voice Notes, click the hotkey field, and press the new combination. Modifier-only keys (⌘, ⌥, ⌃, ⇧) work too — Hapi defaults to Right ⌘ to keep your normal Command key free.

Output behavior

Below the hotkey block, the same panel exposes how transcripts get to your other apps. By default Hapi copies the cleaned text and pastes it where your cursor is.

Settings reference

When you join a meeting in Zoom, Google Meet, Teams, Slack huddles, WhatsApp, FaceTime, or any browser-based meeting on supported hosts, Hapi can detect it and offer to record. You can also start a recording manually from the menu bar for in-person meetings or phone calls.

What gets produced

1. Transcript — full diarized transcript with timestamps and speaker labels.
2. Title — short, factual title generated from the content.
3. Summary — TL;DR plus a topic-by-topic breakdown.
4. Action items — extracted with owner, due date when stated, and a link back to the moment they were said.
5. Entities — people, companies, projects, and decisions mentioned, linked to existing profiles or queued for review.

Settings reference

Editing a finished meeting

Open any meeting from the sidebar to:

• Edit the title, summary, or any topic.
• Re-attribute lines to a different speaker.
• Mark, snooze, or complete action items.
• Run a Play (see below) to repurpose the meeting into something else.
• Append a follow-up recording to the same meeting; Hapi re-runs summary and entities on the merged transcript.

Every meeting and note feeds a private knowledge graph of people, companies, projects, and decisions. Profiles live on your Mac; nothing is published, sold, or shared.

How learning works

1. Extraction. After each transcript, Hapi proposes new entities and links to existing ones.
2. Review queue. Proposals land in a queue you can approve, reject, or merge. Nothing enters your graph until you approve it (unless you turn auto-approve on for high-confidence matches).
3. Edit any time. Open a person or company and edit their name, email, role, company, notes, or relationships. Changes propagate to past meetings.
4. Merge or split. If two profiles refer to the same person, merge them. If one was wrongly combined, split them.

Settings reference

A Play is a saved prompt that runs against a meeting, voice note, person, or your whole library. Hapi ships with a few defaults — follow-up email, decision log, blog draft — and you can write your own.

Anatomy of a Play

Hapi is local-first by default: a quantized Qwen model runs on your Mac and handles summaries, action items, chat, and entity extraction. If your machine is below the recommended 24 GB of RAM, or if you simply prefer to use a frontier model, you can route part of the pipeline to a cloud LLM through OpenRouter.

Settings reference

What never leaves your Mac

• Raw audio recordings.
• The Parakeet speech-to-text model and its output.
• Diarization embeddings (ECAPA, WeSpeaker, Pyannote).
• Text embeddings (GTE) used for search.
• The SQLite database with your transcripts, entities, and history.

In hybrid mode, only the text Hapi chooses to send — the cleaned transcript or summary chunks for a given step — leaves the device, and only to the provider you authorized.

Obsidian

Point Hapi at your vault and it will mirror new transcripts, summaries, and action items as Markdown files. You choose the folder, file naming, and which outputs to sync.

Claude Code

Hapi exposes an MCP server (search meetings, get a meeting, list action items, search entities, semantic search) so Claude Code can answer questions about your knowledge base from any project.

Mail

Optional. When enabled, Hapi reads recent threads from a connected mailbox to link people to their email addresses, detect out-of-office replies, and flag decisions that have drifted between meeting and email. No mail content is sent to the cloud.

Calendar

Read-only access to your macOS Calendar so Hapi can label meetings with the event title, link recordings to invitees, and generate briefings.

Webhooks

Configure URLs to be called when a transcript is finished, when an action item is created, or when a chosen Play produces JSON. Useful for pushing into Notion, Linear, Slack, or your own pipeline.

Automations let you fire actions when something specific happens, without opening Hapi.

Triggers

• Transcription end — fires whenever a meeting or voice note finishes processing.
• Scheduled time — fires at a chosen time, daily or on specific weekdays. Useful for end-of-day digests.
• Keyword match — fires when a transcript contains a chosen word or phrase.
• Speaker detected — fires when a specific person is heard in a recording.

Actions

• Run a Play and append the result to the transcript.
• Send the result to a webhook.
• Write a Markdown file to your Obsidian vault.
• Show a notification.

Where it lives

• ~/Documents/Hapi/Recordings/ — audio files.
• ~/Library/Application Support/Hapi/transcripts.db — transcripts, summaries, action items, entities, and embeddings.
• ~/Library/Application Support/com.hapi.transcription/ — local models (Parakeet, Qwen).

Export

From any meeting or voice note: Export as TXT, Markdown, SRT, JSON, or CSV. From Settings → About → Export everything you can dump your full library at once.

Delete

Delete a single transcript from its detail view, a person from their profile, or everything by removing the folders above. There is no remote copy to clean up.

iOS companion

The iPhone app records and transcribes locally on the phone, then syncs through your private iCloud account to your Mac. Recordings never touch our servers.