---
title: GeoMate V3.0
emoji: 🐢
colorFrom: pink
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