Skip to main content
This guide is optimized for first-time setup. You only need to run setup once — all subsequent runs use the saved config.
1

Install notewise

uv tool install notewise
Need pip or Docker instead? See Installation.
2

Get an API key

The default model is Gemini 2.5 Flash — free tier, no billing required.
  1. Visit aistudio.google.com/app/apikey
  2. Create a new API key
  3. Copy it for the next step
Any supported provider works. See LLM Providers for OpenAI, Anthropic, Groq, and more.
3

Run the setup wizard

notewise setup
The interactive wizard prompts for your provider and API key, then writes ~/.notewise/config.env. Run this once.
4

Process a video

notewise process "https://youtube.com/watch?v=VIDEO_ID"
A live progress dashboard shows while notewise fetches the transcript and generates notes. When finished, open ./output/ to find your Markdown study notes.

​
Example session

$ notewise process "https://youtube.com/watch?v=dQw4w9WgXcQ"

 notewise  v1.0.0

Processing 1 video...

 Video Title
   ✔ Metadata fetched
   ✔ Transcript fetched  (en, 342 segments)
   ✔ Notes generated  (3 chunks)
   ✔ Written → output/Video Title.md

────────────────────────────────────────
  1 processed · 0 failed · 12.4s · $0.0004

​
What to try next

Process a playlist

notewise process "https://youtube.com/playlist?list=PLAYLIST_ID"

Generate a quiz

notewise process "URL" --quiz

Switch LLM model

notewise process "URL" --model gpt-4o

Batch file

notewise process my-urls.txt -o ./notes
If a run fails, start with notewise doctor → notewise config → notewise logs --tail 80. See Troubleshooting for the full guide.