Ga naar inhoud

Aan de slag

Vereisten

  • uv — Python package manager
  • Python 3.11 of hoger (wordt automatisch beheerd door uv)
  • Een API key voor een ondersteund taalmodel — zie Providers & modellen

uv installeren

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Installatie

# 1. Clone de repository
git clone https://github.com/cedanl/onderwijsdata-chat.git
cd onderwijsdata-chat

# 2. Kopieer de voorbeeldconfiguratie
cp .env.example .env

# 3. Vul je model en API key in .env in (zie Configuratie)

# 4. Installeer dependencies
uv sync

Starten

make dev

De app herstart automatisch bij bestandswijzigingen. Open vervolgens je browser op de juiste URL (zie hieronder).

Bereikbaarheid vanuit de browser

Poorten worden automatisch doorgestuurd — open: 

http://localhost:8000

forwardPorts in devcontainer.json werkt niet zonder VS Code. Gebruik het container-bridge-IP: 

make url   # print de juiste URL, bijv. http://172.17.0.2:8000


http://localhost:8000

Chatgeschiedenis inschakelen (optioneel)

Standaard werkt de app zonder login en zonder opgeslagen gespreksgeschiedenis. Schakel het in door twee variabelen toe te voegen aan .env:

# 1. Genereer een secret (eenmalig)
chainlit create-secret

Voeg de output toe aan .env:

CHAINLIT_AUTH_SECRET="<gegenereerde waarde>"
CHAT_USERS=gebruikersnaam:wachtwoord

Meerdere gebruikers zijn mogelijk als kommalijst: CHAT_USERS=alice:ww1,bob:ww2.

Na een herstart verschijnt het loginscherm en wordt elk gesprek automatisch opgeslagen in chat_history.db. Eerdere gesprekken zijn terug te vinden in de linkerzijbalk.

Uitschakelen

Commentarieer CHAINLIT_AUTH_SECRET uit in .env om terug te gaan naar de anonieme modus.

Je eerste vraag

Na het opstarten verschijnt het chatvenster. Probeer bijvoorbeeld:

"Hoeveel studenten zijn er in 2023 ingeschreven in het WO?"

"Vergelijk mbo-diplomering in de G4-steden over de afgelopen 5 jaar en maak een grafiek."

"Welke DUO-datasets zijn beschikbaar over studentprognoses?"

De assistent zoekt automatisch de juiste datasets op, haalt de data op en presenteert resultaten direct in de chat.