Skip to content

Repository files navigation

Marky — de Marktbuddy van Enschede

Een conversational RAG-chatbot voor Markt Enschede, de grootste markt van de Euregio op het H.J. van Heekplein. Marky beantwoordt vragen over openingstijden, kramen, parkeren, bereikbaarheid en meer - voor zowel bezoekers als marktondernemers.

Anti-hallucinatie is een eerste-klas designdoel — verzonnen openingstijden, locaties of regels zijn onaanvaardbaar.


Twee modi

Bezoeker

Marky helpt bezoekers met vragen over:

  • Openingstijden (dinsdag- en zaterdagmarkt)
  • Parkeren en bereikbaarheid (OV, fiets, P+R)
  • Aanbod en kramen (vis, bio, streetfood, bloemen, etc.)
  • Biologische markt aan de Langestraat
  • Contact en locatie

Marktondernemer

Marky beantwoordt vragen over:

  • Huurovereenkomst en standplaatsregels
  • Betaling en stroomverbruik
  • Opzegging en opvolging
  • Handhaving en sancties
  • Terrassen en extra ruimte
  • Afmelden en aanwezigheidsplicht

Tech Stack

  • Python 3.12, FastAPI, Uvicorn
  • LangGraph + LangChain (agent framework)
  • OpenAI GPT-4o-mini
  • pgvector (embeddings)
  • Vanilla HTML/CSS/JS chat UI met Markt Enschede branding
  • Docker (Dokploy deployment)

Snel starten

source .venv/bin/activate
python app.py

Browser → http://localhost:8000

Projectstructuur

marky-chat/
├── app/
│   ├── agent/              # LangGraph agent
│   ├── channels/
│   │   ├── web/chat.html   # Marky chat UI
│   │   ├── gradio/         # Gradio channel
│   │   └── whatsapp/       # WhatsApp webhook
│   ├── chat/domain/        # Service, prompts, guard
│   ├── integrations/
│   │   └── marktenschede/  # Market-specific tools
│   ├── config.py
│   └── main.py
├── assets/marky/           # Marky mascot & branding
├── data/
│   ├── faq.json            # FAQ kennisbasis
│   ├── *.pdf               # Huurovereenkomst & bruikleenovereenkomst
├── tests/
├── CLAUDE.md
└── README.md

Contact

About

Marky chatbot

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages