Skip to content
Back to search

lumen-hybrid-rag-assistant

Hybrid multimodal RAG research assistant: ask questions about your PDFs with citations, GraphRAG, CLIP, LangGraph agent, web search and MCP server.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fadi-hammami--lumen-hybrid-rag-assistant/badge.svg)](/listings/fadi-hammami--lumen-hybrid-rag-assistant)

HTML

<a href="/listings/fadi-hammami--lumen-hybrid-rag-assistant"><img src="/api/listings/fadi-hammami--lumen-hybrid-rag-assistant/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 69 lines
  1. # Lumen: hybrid multimodal RAG research assistant
  2. Upload PDFs, chat with an agent that answers with citations from your documents (text and figures),
  3. and falls back to web search when your documents are not enough.
  4. Keywords: RAG, GraphRAG, CLIP, LangGraph, MCP, DeepEval.
  5. ```
  6. frontend/ web interface (vanilla HTML/CSS/JS, no build step)
  7. backend/ FastAPI: documents, conversations, streaming chat (SQLite)
  8. core/ AI core: ingestion, RAG, GraphRAG, CLIP, web search, LangGraph agent, citations, MCP server
  9. contracts/ shared schemas, Mock Core, sample PDFs
  10. eval/ DeepEval benchmark and dataset
  11. tests/ pytest suite (runs fully offline)
  12. GUIDE.md step-by-step guide to finish and run everything <-- start here
  13. ```
  14. Quick start (offline demo, no API key):
  15. ```bash
  16. python -m venv .venv && source .venv/bin/activate
  17. pip install -r requirements.txt
  18. LLM_PROVIDER=fake ./run.sh # then open http://localhost:8000
  19. ```
  20. For real answers, follow GUIDE.md.
  21. ## Configuration testée : Groq
  22. Le projet fonctionne avec n'importe quel serveur compatible OpenAI. Configuration testée avec Groq
  23. (modèle `openai/gpt-oss-120b`) : dans `.env`, renseigner
  24. LLM_PROVIDER=openai
  25. LLM_MODEL=openai/gpt-oss-120b
  26. OPENAI_API_KEY=<votre clé Groq, ne jamais la committer>
  27. OPENAI_BASE_URL=https://api.groq.com/openai/v1
  28. GRAPH_EXTRACTION=false
  29. WEB_PROVIDER=none
  30. Les noms de modèles disponibles changent selon le compte : vérifier la liste via
  31. `GET https://api.groq.com/openai/v1/models` avec sa clé.
  32. Chaque membre de l'équipe utilise sa propre clé. Le fichier `.env` est ignoré par Git.
  33. ## Documents en français
  34. Pour des PDF en français, le modèle d'embeddings multilingue donne de meilleurs résultats :
  35. EMBEDDING_MODEL=sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
  36. Si le modèle d'embeddings change, il faut réinitialiser les données (arrêter le serveur,
  37. supprimer le dossier `data/`, relancer, recharger les PDF), car l'index et la base de
  38. documents doivent rester cohérents.
  39. ## Corrections apportées
  40. - `core/citations.py` : les marqueurs de citation `【1】` (crochets pleine largeur produits par
  41. certains modèles) sont normalisés en `[1]`, pour que les citations restent cliquables.
  42. - `core/agent.py` : le prompt système interdit au modèle d'écrire des images ou liens markdown,
  43. car les figures sont affichées automatiquement par l'interface.
  44. ## Limites connues
  45. - La recherche web est désactivée dans la configuration testée (`WEB_PROVIDER=none`).
  46. - Le graphe de connaissances est désactivé par défaut (`GRAPH_EXTRACTION=false`) pour ménager
  47. les limites de requêtes du modèle.
  48. - Les formules mathématiques des PDF sont extraites comme du texte et peuvent être déformées.
  49. - Les images affichées ne sont pas filtrées par pertinence : une figure peu liée à la question
  50. peut apparaître en plus de la bonne.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.