README.md

metadata

title: LexNepal AI API
emoji: ⚖️
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: apache-2.0

🇳🇵 LexNepal AI API

Advanced Legal Intelligence API for Nepal Legal Code using Retrieval-Augmented Generation (RAG).

🚀 Features

• Hybrid Retrieval: Dense vector search + keyword matching
• Cross-Encoder Reranking: Precise relevance scoring
• Zero-Hallucination: Answers only from verified legal texts
• Fast & Free: Optimized for CPU inference

🏗️ Architecture

• Embedding Model: all-mpnet-base-v2 (768D)
• Reranking: MS-MARCO Cross-Encoder
• LLM: Llama 3.3 70B (via Groq)
• Vector DB: FAISS (L2 Index)

📡 API Endpoints

• GET / - Interactive API documentation (Swagger UI)
• GET /health - Health check
• GET /stats - Database statistics
• POST /query - Process legal query

💻 Usage Example

curl -X POST "https://YOUR_USERNAME-lexnepal-api.hf.space/query" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are the penalties for theft in Nepal?",
    "max_sources": 10
  }'

🔒 Environment Variables

Set GROQ_API_KEY in Space settings for custom API key.

📊 Dataset

• Total Provisions: 6000+
• Legal Documents: 7 Nepal laws
• Vector Dimensions: 768

🛠️ Tech Stack

• FastAPI
• Sentence Transformers
• FAISS
• Groq API
• Docker

---

Built with ❤️ for Nepal's legal community