https://github.com/krushna-b/sentinel
Full Stack application for real-time satellite visualization
https://github.com/krushna-b/sentinel
data-visualization docker fastapi nextjs postgresql python restful-api
Last synced: 3 months ago
JSON representation
Full Stack application for real-time satellite visualization
- Host: GitHub
- URL: https://github.com/krushna-b/sentinel
- Owner: Krushna-B
- License: mit
- Created: 2025-06-04T02:42:21.000Z (10 months ago)
- Default Branch: release/2025-09-01
- Last Pushed: 2025-12-28T21:56:33.000Z (4 months ago)
- Last Synced: 2025-12-31T14:39:51.552Z (3 months ago)
- Topics: data-visualization, docker, fastapi, nextjs, postgresql, python, restful-api
- Language: TypeScript
- Homepage: https://sentinel-v0.vercel.app
- Size: 246 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sentinel
**Live site:** https://sentinel-v0.vercel.app/globe
LEO satillete positions and orbit visualization. Ingests TLEs, propagates orbits, and serves real-time satillete details via a FastAPI backend on AWS Lambda + API Gateway, a Neon Postgres database, and a Next.js/React 3-D globe.
---
## Overview
Sentinel continuously fetches Two-Line Elements (TLEs), stores historical ephemerides, propagates state vectors (x, y, z, vx, vy, vz), and exposes a clean API and web UI to understand where thousands of objects are and where they’re headed.
- Serverless backend on **AWS Lambda**
- **Neon** (managed Postgres) for storage (SSL required)
- **EventBridge** schedules for ingestion/propagation (cron without always-on servers)
- **Next.js/React** front end (e.g., Vercel) with a **react-globe.gl / Three.js** visualization
- Scales to **28k+ objects**; ~**2.7M state-vector epochs/day**
---
## Features
- FastAPI API layer: latest vectors, per-object TLEs, and bulk orbit sampling
- SGP4 propagation to compute ECI/ECEF positions and derived lat/lon/alt
- Historical storage of objects, TLEs, and propagated state vectors in Postgres
- Copy-paste curl examples and a minimal local dev story
- Container-optional: run locally with Uvicorn, deploy serverless to Lambda
---
## Tech Stack
- Backend: Python, FastAPI, SQLAlchemy, SGP4, Mangum (ASGI→Lambda)
- Data: Neon (PostgreSQL)
- Frontend: Next.js, React, TailwindCSS, react-globe.gl, Three.js
- Cloud: AWS Lambda, EventBridge (schedules)