note-taker

Minimal CLI for capturing voice notes, transcribing, rewriting, and syncing to Notion.

Structure

• src/ application code
• docs/ documentation
• tests/ test suites
• requirements.txt Python dependencies
• data/ local storage (ignored by git)

Getting started

1. Create a virtual environment
2. Install dependencies from requirements.txt
3. Run the CLI

Usage (macOS)

Record a note (press Enter to stop). This will also transcribe, rewrite, and sync to Notion by default:

python -m note_taker record

Optional flags:

python -m note_taker record --out data/raw/custom.m4a
python -m note_taker record --input ":0"
python -m note_taker record --no-process

Notes:

• Recording uses ffmpeg + avfoundation (macOS only).
• Set NOTE_TAKER_DATA_DIR to change the storage location.

Pipeline (free, local)

Transcribe an audio file:

python -m note_taker transcribe data/raw/note_YYYYMMDD_HHMMSS.m4a

Rewrite a transcript with Ollama:

python -m note_taker rewrite data/transcripts/note_YYYYMMDD_HHMMSS.txt

Sync a rewritten note to Notion:

python -m note_taker sync data/rewritten/note_YYYYMMDD_HHMMSS.txt

End-to-end:

python -m note_taker process data/raw/note_YYYYMMDD_HHMMSS.m4a

Convenience script

/Users/cedrichelewaut/Documents/note-taker/bin/note-taker record

Requirements (free)

• ffmpeg installed locally.
• Ollama running locally (default http://localhost:11434) with model llama3.1:8b.
• Notion integration token and database ID in .env.

Notion properties (recommended)

Create these properties in your database for richer entries:

• Summary (text)
• Tags (multi-select)
• Type (multi-select)
• Date (date)

Property names can be overridden via .env:

NOTION_TITLE_PROPERTY=Title
NOTION_SUMMARY_PROPERTY=Summary
NOTION_TAGS_PROPERTY=Tags
NOTION_TYPE_PROPERTY=Type
NOTION_TYPE_MODE=multi_select
NOTION_DATE_PROPERTY=Date