FDS Bot

A locally deployable study assistant for the Foundations of Data Science course at UZH.

FDS Bot answers your questions from the course's own lecture notes and nothing else. It runs on your machine: install the app from PyPI, import the course bundle handed out on the course page, and add a free Gemini API key.

What it does

• Answers grounded in the notes: every reply is built from the course material, not from the model's general knowledge.
• Citations you can open: each answer names the sections it used, and a click opens the lecture-notes PDF at that page with the quoted lines highlighted.
• Quotes checked against the source: the verbatim lines an answer quotes are checked locally against the notes, and a quote that cannot be confirmed is flagged rather than quietly shown.
• Section summaries: ask it to summarize a section and it works through that section's whole subtree in order, not just the passages that matched.
• Math and code render properly: answers stream in with LaTeX and syntax highlighting.

It is still a language model: it can be wrong, and it can be confidently wrong. Every answer carries its citations, so check it against the notes before you rely on it.

Requirements

• Python 3.10–3.14: check with python3 --version (py --version on Windows). If pip says no matching distribution found, install Python 3.14 or older and try again.
• The course bundle: fds-bot-data-YYYY-MM-DD.tar.gz (about 65 MB), from the FDS course page. It holds the lecture notes and the search indices built from them: course material shared only with enrolled students through the course page.
• A Gemini API key: free from Google AI Studio.
• An internet connection: the notes and the search run on your machine, but the answers are generated by Google's Gemini API.

Installation

pip install fds-bot

If pip throws errors or if the install succeeds but fds-bot is then "command not found", install it into its own environment instead:

pipx install fds-bot

Then download the course bundle from the FDS course page and leave it packed, the app takes the file exactly as it downloaded.

Running it

fds-bot

The server starts and your browser opens at http://127.0.0.1:8000/. The terminal stays almost silent, and that is the healthy state rather than a stalled start:

fds-bot is ready: open http://127.0.0.1:8000/ in your browser.

Press Ctrl+C to stop.

Only errors are logged, so anything printed alongside those lines is worth reading. The address is printed on every launch, and you can always open it yourself.

First launch

The first start asks for two things, right where you would chat:

• The course bundle: drag the downloaded .tar.gz onto the page, or use the file picker. The app copies it into its own data folder under ~/.fds-bot/, so you can delete the download afterwards.
• A Gemini API key: paste in a free key from Google AI Studio and you are ready to go.

Keeping the course material up to date

When the notes are updated mid-semester, download the new file and import it from Settings → Course material → Replace. That settings card shows the build date of the bundle you have, and fds-bot --version prints it next to the app version.

Command-line options

Your data stays on your machine

Your API key, your conversations, your settings, and the imported course bundle all live under ~/.fds-bot/.

Support

Found a wrong answer or a bug? The app has a built-in feedback flow: select the answers in question and click Copy package, and the app and model metadata are filled in for you, then use Open email app or Download .md on the screen that follows, and send the result to the course maintainer.

Source access is internal to the UZH DaST group. Contact mayer@ifi.uzh.ch or giuseppe.doda@uzh.ch. Contributors working from a checkout: see CONTRIBUTING.md.

License

The application code is released under the MIT License. The course bundle is not covered by it: the lecture notes and everything derived from them are licensed for use by enrolled FDS students only, and must not be redistributed.