Week 5 (AI track): Guided build#
See also
Full context: root README, Week 5.
Goal#
A small app around a model, plus an intro to retrieval, with instructions that are still fairly step-by-step.
Scope#
- A summarizer, classifier, or chatbot with real memory, built around a hosted model's API.
- Retrieval, conceptually: why raw model calls aren't enough for anything that needs facts, what a vector search does.
The project: Notes Assistant#
This week (and Weeks 6-7 after it) builds one continuous project: Notes Assistant, a command-line tool that summarizes personal text notes and answers questions about them using a simple, from-scratch version of retrieval. It's chosen specifically because it maps onto the skills the Week 8 "docs assistant" capstone needs (retrieval, source citation, refusing to guess when the documents don't cover a question), without building that capstone itself.
Do this in order#
Steps 1-4 are required. Everything after is optional extra practice; skipping straight to Week 6 without it leaves no gap in what Week 6 assumes you know.
notes/01-why-retrieval-matters.mdthrough03-organizing-notes-assistant.md, in order.exercises/00-guided-build-retrieval.md, a line-by-line guided build of the retrieval core (no API key needed), before the project walkthrough.exercises/01_single_prompt.py,02_multi_turn_chat.py,03_structured_extraction.py, in order: the API-shape progression from a single call to real memory to structured output.project/README.md's full walkthrough of the finishednotes_assistant.py.- Optional:
exercises/04-guided-build-citations.md, a second guided, line-by-line build (also no API key needed), the citation-formatting logicanswer_questiondepends on. - Optional, any order:
exercises/05through11, further standalone reps (naive substring matching vs. keyword overlap, a second chunking strategy, adding your own sample note, chunk overlap, stopword tuning,top_ktuning, whether the system prompt is really grounding the answer). Most need no API key; seeexercises/README.mdfor exactly which ones do. - Optional:
project/bonus_vector_similarity.py, a real vector and similarity formula in plain Python.
Status#
Note
Notes, exercises, and the guided project walkthrough are written. Weeks 6 and 7 extend project/notes_assistant.py from this week; nothing here is a placeholder.