README.md

metadata

title: Borges Graph
emoji: 📚
colorFrom: yellow
colorTo: red
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
python_version: 3.11
pinned: false
license: mit
short_description: GraphRAG Explorer for Borgesian Literature Analysis

📚 Borges Graph - GraphRAG Explorer

Une application Gradio interactive pour explorer vos données GraphRAG à travers l'intelligence artificielle. Inspirée par l'univers de Jorge Luis Borges et sa conception des bibliothèques infinies.

✨ Fonctionnalités

• 🔍 Recherche intelligente: Posez des questions en langage naturel sur vos livres
• 📊 Modes de recherche: Local (focalisé) ou Global (vue d'ensemble)
• 📚 Gestion de livres: Uploadez et traitez de nouveaux textes
• 🌐 API externe: Connexion optionnelle à l'API Borges déployée
• 🎯 Interface intuitive: Design élégant inspiré de l'esthétique borgésienne

🚀 Installation et déploiement

Installation locale

pip install -r requirements.txt
python app.py

Déploiement sur Hugging Face Spaces

1. Forkez ou clonez ce repository
2. Créez un nouvel Space sur Hugging Face
3. Uploadez les fichiers de ce dossier
4. Configurez les variables d'environnement si nécessaire:
   • OPENAI_API_KEY: Votre clé API OpenAI
   • BORGES_API_URL: URL de votre API Borges (optionnel)
   • ENABLE_EXTERNAL_API: "true" pour activer la connexion API externe

📋 Utilisation

Mode local

1. Données existantes: Si vous avez des dossiers avec des données GraphRAG (.graphml), ils seront automatiquement détectés
2. Nouveaux textes: Uploadez un fichier .txt qui sera traité automatiquement
3. Données pré-traitées: Uploadez un fichier .zip contenant des données GraphRAG existantes

Mode API externe

Activez l'option "Utiliser l'API Borges" pour interroger directement votre application déployée sur Vercel.

🔧 Configuration

Variables d'environnement

• OPENAI_API_KEY: Requis pour le traitement GraphRAG local
• BORGES_API_URL: URL de l'API externe (défaut: https://borges-library.vercel.app/api/graphrag)
• ENABLE_EXTERNAL_API: Active l'option API externe dans l'interface

Formats de fichiers supportés

• 📄 .txt: Texte brut qui sera traité par GraphRAG
• 📦 .zip: Archive contenant des données GraphRAG pré-traitées

🏗️ Architecture

L'application est construite avec:

• Gradio: Interface utilisateur interactive
• nano-graphrag: Moteur de traitement GraphRAG
• NetworkX: Manipulation des graphes
• OpenAI API: Modèles de langage pour l'analyse

🎨 Interface

L'interface comprend deux onglets principaux:

1. 🔍 Recherche: Pour interroger vos données
2. 📚 Gestion des livres: Pour uploader et gérer vos textes

🤝 Intégration avec l'écosystème Borges

Cette application Gradio est conçue pour fonctionner en synergie avec:

• Borges Library Web: Interface principale déployée sur Vercel
• GraphRAG API: API backend pour les requêtes GraphRAG
• Neo4j: Base de données graphe pour la persistance

🔗 Liens

• nano-graphrag
• Gradio
• Hugging Face Spaces