Skip to content

manojmallick/conferencemap

Repository files navigation

◆ ConferenceMap — Verified by SigMap

The AI conference companion that eliminates hallucination — every answer sourced, cited, and token-optimised.

Live Demo

Next.js 15 TypeScript React 19 KendoReact Gemini 2.5 Flash Google Cloud Run License: MIT

Built for the Progress × GitNation Hackathon · JSNation + React Summit Amsterdam 2026


Why it's different

Generic chatbots hallucinate conference details — wrong speaker, wrong time, wrong room. ConferenceMap is not a chatbot wrapper, it's a verification layer. SigMap pre-filters the entire conference corpus to only the relevant chunks before any token reaches Gemini, then verifies every factual claim in the answer against those chunks. The whole pipeline is transparent: input tokens, output tokens, latency, cost, citations, and a faithfulness score are shown live on every reply.

~60–97% input-token reduction by SigMap (scales with corpus size)
0.3–2s first-token latency (Gemini 2.5 Flash, streaming)
100% of factual claims cited and verified post-generation
0 hallucinations — the model declines when context is missing

Features

  • Ask — conversational Q&A with verified, cited answers, a live trust panel, and smart follow-up suggestions
  • Sessions — KendoReact Grid with natural-language AI filtering
  • Agenda — personal time-blocked schedule
  • Organiser — engagement analytics + coverage-gap detection
  • For Judges — a built-in /judges walkthrough of what to try and what to look for

Live demo

https://conferencemap-908307939543.europe-west4.run.app

Quick start

npm install
cp .env.example .env.local   # add GEMINI_API_KEY (must start with "AIza") from aistudio.google.com/apikey
npm run dev                  # http://localhost:3000

KendoReact license: the Grid/TileLayout show an "Invalid license" watermark until a (free) Telerik key is activated. Drop telerik-license.txt in the project root and run npx kendo-ui-license activate. The key is gitignored.

Configuration

Env var Default Purpose
GEMINI_API_KEY Gemini API key (starts with AIza)
LLM_FOLLOWUPS true true = Gemini-generated follow-ups; false = instant templates

Architecture

Architecture

A single Next.js 15 process — no separate API server, no vector DB. The TF-IDF index lives in module memory, built once at cold start and reused per request. Full detail in ARCHITECTURE.md.

Browser (KendoReact)
  → POST /api/query  (SSE)
Next.js API route
  ├─ SigMapIndex.assembleContext()   in-memory TF-IDF → preflight
  ├─ Gemini 2.5 Flash streaming      @google/genai → first_token, text…
  ├─ verifyAnswer()                  faithfulness check → final_metrics
  └─ follow-ups (LLM or template)    → suggestions
  → SSE events → TokenPanel UI

Tech stack

  • Next.js 15 — App Router, API routes, SSE streaming, standalone build
  • KendoReact — Grid, TileLayout, ProgressBar, Loader, Buttons, Input
  • SigMap — TF-IDF context assembly + post-generation faithfulness verification
  • @google/genai — Gemini 2.5 Flash, streaming, usageMetadata, thinking tokens
  • Google Stitch — UX design (design/)
  • Google Cloud Run (europe-west4) — containerised, min-instances=1

Deploy

gcloud run deploy conferencemap --source . --region europe-west4 \
  --allow-unauthenticated --min-instances 1 --memory 512Mi --cpu-boost \
  --set-env-vars "GEMINI_API_KEY=your_key_here"

Documentation

Author

Manoj Mallick@manojmallick · LearnHubPlay Built on SigMap, an open-source context verification layer.

License

MIT — knowledge about your conference should be free.

About

Verified AI conference companion — every answer sourced, cited & token-optimised by SigMap. Zero hallucination by construction. Next.js 15 · KendoReact · Gemini 2.5 Flash · Cloud Run.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors