Update README.md

README.md

@@ -12,4 +12,28 @@ tags:
 short_description: Connect to more than 20 datasource and ask question
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# Ibiza Server
+
+Ibiza Server is a lightweight MCP server designed for **natural language question answering** over multiple SQL-compatible databases or files sources like csv or parquet. It empowers users to ask questions in plain English (or any supported language), then generates safe and optimized SQL queries using large language models and reranking techniques.
+
+I have this for the Agent-MCP-Hackathon in the track : mcp-server-track.
+
+A huge thanks to the **Modal** team for providing compute credits that enabled me to deploy two essential services for Ibiza:
+
+  - A reranking API powered by Qwen3-Reranker-4B, used to identify the most relevant tables based on the user’s question.
+
+  - A SQL generation service using Qwen3-14B with vLLM, which generates validated SQL queries and natural language explanations.
+
+## ✨ Key Features
+
+- 🔌 **Multi-database compatibility**: Connects to MySQL, PostgreSQL, SQLite, Snowflake, and more via [Ibis](https://ibis-project.org/).
+- 🧠 **AI-powered SQL generation** using **Qwen3-14B** via a custom VLLM inference server.
+- 🛡️ **SQL validation and transpilation** using [SQLGlot](https://github.com/tobymao/sqlglot).
+- 📊 **Table relevance reranking** with **Qwen3-Reranker-4B** via a dedicated reranking API.
+- 🗣️ **Natural language answers** returned alongside query results.
+
+## Demo
+
+- With an online **PostgreSQL** database : https://www.youtube.com/watch?v=CC9Z1wHNDPA
+- With an online **CSV** dataset : https://www.youtube.com/watch?v=XiOmvVkuesg