metadata
title: GraphWiz Ireland
emoji: 🍀
colorFrom: green
colorTo: yellow
sdk: streamlit
sdk_version: 1.36.0
app_file: src/app.py
pinned: false
license: mit
🍀 GraphWiz Ireland - Advanced GraphRAG Q&A System
Intelligent question-answering about Ireland using GraphRAG, hybrid search, and Groq LLM.
Features
- 📚 Comprehensive Wikipedia knowledge base (10,000+ articles, 86K+ chunks)
- 🔍 Hybrid search (HNSW semantic + BM25 keyword)
- 🧠 GraphRAG with community detection (16 topic clusters)
- ⚡ Sub-second responses via Groq API (Llama 3.3 70B)
- 📊 Citation tracking and confidence scores
- 💾 Intelligent caching for instant repeated queries
How it works
- Data: ALL Ireland-related Wikipedia articles extracted
- Processing: Text chunking with entity extraction (spaCy)
- GraphRAG: Hierarchical knowledge graph with community detection
- Search: HNSW semantic (98% accuracy) + BM25 keyword fusion
- Generation: Groq LLM for natural answers with citations
Example Questions
- What is the capital of Ireland?
- Tell me about the Easter Rising
- Who was Michael Collins?
- What are the provinces of Ireland?
- Explain Irish mythology and the Tuatha Dé Danann
Configuration
The app has a sidebar with these settings:
- top_k: Number of chunks to retrieve (3-15, default: 5)
- semantic_weight: Semantic vs keyword balance (0-1, default: 0.7)
- use_community_context: Include topic summaries (default: True)
Technical Stack
Built with:
- Streamlit - Interactive web interface
- HNSW (hnswlib) - Fast approximate nearest neighbor search
- spaCy - Named entity recognition and text processing
- Groq - Ultra-fast LLM inference
- NetworkX - Graph algorithms for community detection
- Sentence Transformers - Text embeddings
License
MIT License
Note: This space requires a GROQ_API_KEY secret to be configured in Settings → Repository secrets. Get your free API key at https://console.groq.com/