Skip to main content

STAC GIS Core

Welcome to the documentation for STAC GIS Core — the STAC-compliant platform: a FastAPI backend, a React frontend, and full-stack deployment for an AI-powered Earth Observation and GIS platform.

📚 New to STAC GIS? Start with the platform introduction and the platform overview to see how Core, Geo-AI, and the Catalog fit together.

This platform bridges high-resolution environmental data cubes with conversational AI capabilities, allowing users to query, analyze, and visualize geospatial assets directly using natural language.

🗺️ Documentation Road Map​

To get started with developing or deploying STAC GIS, follow the guides below:

🚀 Getting Started​

Learn how to get the project up and running locally or in staging:

  • Installation Guide: Setup dependencies, docker containers, backend environment, and frontend workspace.
  • Configuration Reference: Complete guide to backend environmental keys, Redis database configurations, MinIO credentials, and LLM providers.

🏗️ Architecture & Deep Dives​

Understand the underlying components and design patterns:

  • System Architecture Overview: High-level overview of services, request-response flows, and microservices architecture.
  • Backend Design: Exploring the FastAPI layer, Domain-Driven Design (DDD) principles, database schema models, and Celery worker queues.
  • Frontend Monorepo: Layout of shared visual libraries (map, ui, charts) and the main client application (stacgis).
  • AI Agent Framework: Comprehensive deep-dive on the ReAct (Reasoning and Acting) execution loops, Model Context Protocol (MCP) tool integration, and local LLM execution.

🤝 Contributing & Releases​

Contribute code, test your updates, and publish official packages:

  • Contributing Guidelines: Best practices for coding style standards, ruff/eslint checks, git workflow, and unit/integration testing.
  • Release Checklist: Requirements for tags, docker compilation steps, migration verification, and semantic versioning releases.

📂 Repository Layout​

stac-gis/core/
├── backend/                  # FastAPI Application
│   └── stacgis/          # Core backend package
├── frontend/                 # Frontend monorepo (pnpm workspace)
│   ├── apps/                 # Client applications
│   └── packages/             # Shared frontend libraries
├── docs/                     # Docusaurus documentation (this site)
├── docker-compose.yml        # Orchestration for local development & services
└── folder_structure.txt      # Automated layout registry