Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,80 @@
 ---
-title: Judilibre Api
-emoji: 🚀
-colorFrom: red
-colorTo: purple
+title: JUDILIBRE API - French Court Decisions
+emoji: ⚖️
+colorFrom: blue
+colorTo: red
 sdk: gradio
-sdk_version: 5.38.0
+sdk_version: 4.19.2
 app_file: app.py
-pinned: false
+pinned: true
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# JUDILIBRE API MCP Server
+
+Production-ready API server for accessing French court decisions from the Cour de cassation.
+
+## Features
+
+- 🔍 **Full-text search** - Search through 1.3M+ court decisions
+- 📊 **Real-time statistics** - Database metrics and usage stats
+- 🏛️ **Legal taxonomy** - Structured classifications and terms
+- 📄 **Complete decisions** - Full text with structured zones
+- ⚡ **High performance** - Elasticsearch-powered search
+- 🔒 **Secure** - OAuth 2.0 authentication
+
+## Available Endpoints
+
+### Core Endpoints (6 working)
+- `GET /api/healthcheck` - Check API availability
+- `GET /api/stats` - Get database statistics
+- `GET /api/taxonomy` - Get legal classifications
+- `GET /api/search` - Search court decisions
+- `GET /api/decision` - Get specific decision
+
+### Utility Endpoints
+- `GET /api/search/contract` - Quick contract search
+- `GET /api/search/recent` - Recent decisions
+- `GET /api/search/chamber/{code}` - Search by chamber
+
+## Data Coverage
+
+- **Total Decisions**: 1,316,065+
+- **Time Period**: 1800s to present
+- **Jurisdictions**: Cour de cassation, Cours d'appel
+- **Types**: Civil, Criminal, Commercial, Social
+
+## Organization
+
+- **Company**: AB GROUPE
+- **SIRET**: 94432843400013
+- **Application**: Sobro
+
+## API Status
+
+- **Working**: 6/8 endpoints (75%)
+- **Production Ready**: Yes
+- **Core Functionality**: Fully operational
+
+## Example Usage
+
+### Search for decisions
+```
+GET /api/search?query=contrat&page_size=10
+```
+
+### Get specific decision
+```
+GET /api/decision?id=686f55a53f11a71c18e869a4
+```
+
+### Get recent decisions
+```
+GET /api/search/recent?days=7
+```
+
+## Technical Details
+
+- **Authentication**: OAuth 2.0
+- **Rate Limits**: Standard PISTE limits apply
+- **Response Format**: JSON
+- **Documentation**: Available at root path `/`