README.md

metadata

title: SatQuery API
emoji: 🛰️
colorFrom: blue
colorTo: green
sdk: gradio
app_file: app.py
python_version: 3.12.12
short_description: Satellite and aerial imagery analysis API

SatQuery FastAPI service launched by the Gradio Space Python runner on port 7860. This custom Python use of the Gradio SDK is an unofficial Hugging Face workflow. Set SATQUERY_CORS_ORIGINS in Space Settings to the exact Vercel frontend origin, for example https://satquery.vercel.app.

Attach a read-write Storage Bucket at /data, then set SATQUERY_ARTIFACT_DIR=/data/artifacts and SATQUERY_DATABASE_PATH=/data/artifacts/satquery.sqlite3 to preserve uploaded imagery, SQLite history, and analysis artifacts across Space restarts. Without those settings, the local artifacts directory is temporary.

ZeroGPU does not automatically accelerate this API. Its model calls are CPU-bound unless explicitly adapted to Hugging Face's ZeroGPU decorators; available CPU and memory may be insufficient for some analyses. Verify build logs and representative requests before relying on this deployment.

The /health endpoint checks service availability.

This API does not include user authentication. A public Space should be used with non-sensitive demonstration imagery only.