README.md

metadata

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

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