🛰️ AstraGraph

AstraGraph is an independent, satellite-verified infrastructure monitoring platform that combines Sentinel-2 imagery, Neo4j Knowledge Graphs, and Procurement Machine Learning.

Phase 1: Setup & Quickstart

1. Requirements

• Docker Desktop installed and running
• Postgres and Neo4j ports available (5432, 7474, 7687)
• Node.js v18+ and Python 3.11+
• A Google Earth Engine account (Free tier)

2. Environment Setup

# 1. Duplicate environment file
cp .env.example .env

# 2. Add your Google Earth Engine project ID to .env
# (Get this from https://code.earthengine.google.com/)

3. Initialize Backend

# 1. Start databases (PostgreSQL, Neo4j, Redis)
make up

# 2. Setup Python Virtual Environment
python -m venv .venv
source .venv/Scripts/activate  # (Windows)
# source .venv/bin/activate    # (Mac/Linux)

# 3. Install Python dependencies
pip install -r api/requirements.txt

# 4. Initialize schemas and Seed Demo Data
# NOTE: This creates 50 realistic projects and 200 contractors
make seed-demo

# 5. Start FastAPI Backend (Auto-reloads on port 8000)
make demo

4. Initialize Frontend

Open a new terminal tab:

cd frontend
npm install
npm run dev
# Vite will start on http://localhost:5173