Update README.md

README.md

@@ -6,5 +6,28 @@ colorTo: green
 sdk: docker
 pinned: false
 ---
+# GeoMate V3 — FastAPI + React (Docker) — Deployable on Hugging Face Spaces
 
+## Quick overview
+This repository contains a deployable FastAPI backend and React frontend for GeoMate V3 (geotechnical assistant). The Dockerfile builds the React frontend and runs the FastAPI server.
+
+## Secrets (set in HF Space Settings → Secrets)
+- `GROQ_API_KEY` — Groq API key (optional, for RAG)
+- `SERVICE_ACCOUNT` — Earth Engine service account email (optional)
+- `EARTH_ENGINE_KEY` — Earth Engine service account JSON (paste entire JSON)
+
+If secrets are not present, the app runs with reduced functionality and clear messages.
+
+## Deploy to Hugging Face (Docker)
+1. Create a new Space on Hugging Face: https://huggingface.co/new-space
+   - Choose **Docker** as the SDK.
+2. Upload or push this repository to the Space.
+3. In Space settings → Secrets, add `GROQ_API_KEY`, `SERVICE_ACCOUNT`, `EARTH_ENGINE_KEY` (if using EE).
+4. Wait for the build — HF will run the Dockerfile and start the app.
+5. The app will be available at `https://<your-space>.hf.space`.
+
+## Run locally with Docker
+```bash
+docker build -t geomate-v3 .
+docker run -p 7860:7860 -e GROQ_API_KEY="..." -e SERVICE_ACCOUNT="..." -e EARTH_ENGINE_KEY="$(cat key.json)" geomate-v3
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference