Rewrite README in English

README.md

@@ -1,5 +1,5 @@
 ---
-title: Data Analyst Mcp
+title: Data Analyst MCP
 emoji: 🚀
 colorFrom: green
 colorTo: purple
@@ -7,58 +7,58 @@ sdk: gradio
 sdk_version: 6.12.0
 app_file: app.py
 pinned: false
-short_description: Analyse and generate stats and graphs from sql database
+short_description: Analyze survey data and generate stats and charts from SQL
 ---
 
 # Data Analyst agent with MCP
 
-Assistant data orienté analyse de table `surveyData`, avec génération automatique de graphiques.
+A data analysis assistant focused on the `surveyData` table, with automatic chart generation.
 
-## Ce que fait l’app
+## What this app does
 
-- Pose des questions en langage naturel sur les données du survey.
-- Exécute les requêtes via des tools MCP.
-- Génère des graphiques (`bar`, `pie`, `line`) quand c’est pertinent.
-- Affiche les résultats dans une interface Gradio compatible Hugging Face Spaces.
+- Answers natural-language questions about survey data.
+- Runs data queries through MCP tools.
+- Generates charts (`bar`, `pie`, `line`) when useful.
+- Displays results in a Gradio UI that works well on Hugging Face Spaces.
 
-## Stack technique
+## Tech stack
 
 - Python 3.11+
 - [Gradio 6.12.0](https://www.gradio.app/)
-- `smolagents` + client MCP (transport SSE)
-- Azure OpenAI (modèle configurable)
-- `matplotlib` + `seaborn` pour les charts
+- `smolagents` + MCP client (SSE transport)
+- Azure OpenAI (configurable model)
+- `matplotlib` + `seaborn` for charts
 
-## Structure du projet
+## Project structure
 
 ```text
 .
-├── app.py            # UI Gradio + orchestration agent
-├── tools.py          # Tool local generate_chart(...)
-├── prompt.py         # Instructions système de l’agent
-├── charts/           # Images PNG générées
+├── app.py            # Gradio UI + agent orchestration
+├── tools.py          # Local tool: generate_chart(...)
+├── prompt.py         # Agent system instructions
+├── charts/           # Generated PNG files
 ├── requirements.txt
 └── README.md
 ```
 
-## Pré-requis
+## Prerequisites
 
-- Un endpoint MCP accessible en SSE.
-- Un déploiement Azure OpenAI configuré.
-- Un fichier `.env` (au niveau parent du dossier projet, comme dans le code actuel).
+- An MCP endpoint reachable over SSE.
+- An Azure OpenAI deployment.
+- A `.env` file (currently loaded from the parent directory of this project).
 
-## Variables d’environnement
+## Environment variables
 
-Variables utilisées par `app.py` :
+Used by `app.py`:
 
-- `MCP_SERVER_URL` (ex: `https://.../gradio_api/mcp/sse`)
+- `MCP_SERVER_URL` (example: `https://.../gradio_api/mcp/sse`)
 - `AZURE_OPENAI_ENDPOINT`
 - `AZURE_OPENAI_API_KEY`
-- `AZURE_OPENAI_API_VERSION` (défaut: `2024-12-01-preview`)
-- `AZURE_OPENAI_MODEL` (défaut: `gpt-4o`)
-- `PORT` (défaut: `7860`)
+- `AZURE_OPENAI_API_VERSION` (default: `2024-12-01-preview`)
+- `AZURE_OPENAI_MODEL` (default: `gpt-4o`)
+- `PORT` (default: `7860`)
 
-Exemple `.env` minimal :
+Minimal `.env` example:
 
 ```env
 MCP_SERVER_URL=https://your-mcp-server/gradio_api/mcp/sse
@@ -68,7 +68,7 @@ AZURE_OPENAI_API_VERSION=2024-12-01-preview
 AZURE_OPENAI_MODEL=gpt-4o
 ```
 
-## Installation locale
+## Run locally
 
 ```bash
 python3 -m venv venv
@@ -77,83 +77,83 @@ pip install -r requirements.txt
 python app.py
 ```
 
-Puis ouvrir `http://localhost:7860`.
+Then open `http://localhost:7860`.
 
-## Déploiement Hugging Face Spaces
+## Deploy to Hugging Face Spaces
 
-Ce repo est déjà configuré en Space Gradio via le front-matter en haut du README.
+This repository is already configured as a Gradio Space through the front-matter at the top of this README.
 
-Workflow simple :
+Simple workflow:
 
-1. Modifier le code.
-2. Commit sur `main`.
-3. Push vers le remote Space:
+1. Make your code changes.
+2. Commit on `main`.
+3. Push to the Space remote:
 
 ```bash
 git push origin main
 ```
 
-Le Space rebuild automatiquement.
+The Space rebuilds automatically.
 
-## Logique fonctionnelle (résumé)
+## Runtime flow (high level)
 
-1. L’utilisateur pose une question.
-2. `ToolCallingAgent` appelle les tools MCP (et `generate_chart` si utile).
-3. Si un chart est généré, il est encodé en base64 et affiché inline.
-4. La réponse texte de l’agent est affichée dans le chat.
+1. User asks a question.
+2. `ToolCallingAgent` calls MCP tools (and `generate_chart` when relevant).
+3. If a chart is generated, it is encoded in base64 and rendered inline.
+4. The assistant answer is shown in chat.
 
-## Prompting / règles data importantes
+## Prompting / important data rule
 
-Dans `prompt.py`, une contrainte est imposée:
+In `prompt.py`, one strict rule is enforced:
 
-- la table SQL cible est **toujours** `"surveyData"` (avec `D` majuscule)
+- the SQL table is always **`"surveyData"`** (capital `D`)
 
-Si le backend SQL évolue, commence par mettre à jour cette partie.
+If your SQL backend changes, update this part first.
 
-## Exemples de questions utiles
+## Useful example questions
 
-- `Le nombre de questions qu'on a`
+- `How many questions do we have?`
 - `Sub-options per question`
 - `Distribution by question type`
 - `Top 5 questions by number of sub options`
-- `Pourcentage de répartition des questions`
+- `Percentage distribution of questions`
 
-## Dépannage
+## Troubleshooting
 
 ### 1) `SSE Stream ended` / `httpx.ConnectError`
 
-Cause fréquente: endpoint MCP inaccessible (URL fausse, serveur en sleep, problème réseau).
+Common cause: MCP endpoint is unreachable (wrong URL, sleeping service, network issue).
 
-À vérifier:
+Check:
 
-- `MCP_SERVER_URL` correct
-- endpoint joignable depuis l’environnement de déploiement
-- serveur MCP bien démarré
+- `MCP_SERVER_URL` is correct
+- endpoint is reachable from the deployment environment
+- MCP server is actually running
 
-### 2) Erreurs Gradio au startup
+### 2) Gradio startup errors
 
-Exemples déjà rencontrés:
+Examples already encountered:
 
-- argument `type` non supporté sur `gr.Chatbot`
-- argument `bubble_full_width` non supporté
+- unsupported `type` argument on `gr.Chatbot`
+- unsupported `bubble_full_width` argument
 
-Si ça revient, vérifie la version exacte de Gradio dans `requirements.txt` et adapte les paramètres du composant.
+If this happens again, confirm the Gradio version in `requirements.txt` and align component parameters accordingly.
 
-### 3) Interface qui s’allonge à l’infini dans Space
+### 3) UI page growing infinitely on Spaces
 
-Le projet utilise désormais un layout Gradio natif + CSS minimal pour éviter ce bug d’iframe HF.
+The app now uses a native Gradio layout + minimal CSS to avoid iframe-related layout issues.
 
-### 4) Aucune clé API Azure
+### 4) Missing Azure key
 
-Sans `AZURE_OPENAI_API_KEY`, l’agent ne peut pas répondre.
-Vérifie les Secrets dans Space Settings.
+Without `AZURE_OPENAI_API_KEY`, the assistant cannot answer.
+Set it in Space Settings > Secrets.
 
-## Notes de maintenance
+## Maintenance notes
 
-- Les images de charts sont stockées dans `charts/`.
-- `generate_chart` crée des PNG avec un nom dérivé du titre.
-- Si besoin de nettoyage disque, supprimer périodiquement les anciens fichiers dans `charts/`.
+- Generated charts are stored in `charts/`.
+- `generate_chart` saves PNG files with a title-derived filename.
+- If needed, clean old files in `charts/` periodically.
 
-## Référence utile
+## Helpful reference
 
-- Config Spaces: https://huggingface.co/docs/hub/spaces-config-reference
+- Spaces config docs: https://huggingface.co/docs/hub/spaces-config-reference