Skip to content

About

AI-powered Space Traffic Management Platform that monitors orbital traffic, predicts satellite collisions, simulates Kessler Syndrome cascades, and generates autonomous avoidance maneuvers using a 5-agent AI system. Built with Next.js, CesiumJS, LangGraph, Gemini AI, and MongoDB.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

5 Commits

Folders and files

Repository files navigation

๐Ÿ›ฐ๏ธ SpaceSafe X

Autonomous AI-Powered Space Traffic Management Platform

Mission Control. Real-time collision prediction. Multi-agent AI. Built for the final frontier.

Next.js TypeScript TailwindCSS LangGraph CesiumJS FAR AWAY Hackathon

Live Demo ยท Judge Mode ยท Docs ยท Hackathon


๐Ÿ“ธ Screenshots

Landing Page Mission Control Dashboard
Landing Page Dashboard
Earth Visualization AI Agent System
Earth View AI Agents

| Kessler Cascade Simulator | Kessler Simulator |


๐ŸŽฏ What is SpaceSafe X?

SpaceSafe X is a mission-control-grade AI platform that autonomously monitors orbital traffic, predicts satellite collisions, simulates Kessler syndrome cascades, and generates avoidance maneuvers โ€” all in real-time.

The platform combines a multi-agent AI system (5 specialized agents via LangGraph), a 3D Earth visualization (CesiumJS), and a live threat dashboard to give operators immediate situational awareness of the space environment.

"Protecting orbits. Ensuring tomorrow."


๐Ÿš€ The Problem

Earth orbit is rapidly becoming a collision crisis zone:

  • 34,000+ tracked objects currently in orbit
  • 1,000,000+ debris fragments too small to track but large enough to destroy satellites
  • $300B+ in satellite infrastructure at existential risk
  • A single high-energy collision can generate thousands of new debris fragments
  • Cascading collisions can render entire orbital shells permanently inaccessible (Kessler Syndrome)

Existing space traffic management is manual, slow, and reactive. SpaceSafe X makes it autonomous, instant, and proactive.


โœจ Core Features

๐ŸŒ 3D Earth Visualization

  • CesiumJS-powered photorealistic globe with real satellite TLE data
  • Live orbital paths with animated satellite positions
  • Atmospheric glow, cloud layer, day/night terminator, city lights
  • Interactive satellite selection and real-time telemetry readouts
  • Risk zone heatmap overlay showing conjunction hotspots

๐Ÿ›ก๏ธ Collision Prediction Engine

  • Real-time conjunction analysis for all tracked object pairs
  • Probability of collision (Pc) computation with confidence intervals
  • Miss distance calculation and time-to-impact countdown
  • Status classification: critical / warning / low

๐Ÿค– Multi-Agent AI System

  • 5 specialized AI agents operating through a LangGraph pipeline
  • Agents collaborate sequentially to produce autonomous decisions
  • Explainable reasoning โ€” every decision logged with confidence scores
  • Average pipeline execution time: < 10 seconds

โ˜ข๏ธ Kessler Cascade Simulator

  • Simulate a full orbital debris cascade event in real-time
  • Side-by-side: Without AI vs With AI Intervention
  • Risk heatmap overlay, explosion flash effects, debris particle system
  • Typical AI result: 93.6% risk reduction, 44 collisions prevented

๐ŸŽฌ Judge Mode

  • One-click 30โ€“45 second guided product demonstration
  • Auto-advances through all 7 platform stages with cinematic transitions
  • Accessible from navbar, hero section, and dashboard
  • No user interaction required โ€” ideal for live demos and evaluations

๐Ÿ“Š Mission Control Dashboard

  • Bloomberg Terminal-level information density
  • Mission Summary panel: threats, collisions prevented, risk reduction
  • Live threat center with countdown timers and AI maneuver readouts
  • Animated stat cards, orbital distribution, 24h activity sparkline

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                         SpaceSafe X                             โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Frontend  (Next.js 16 ยท TypeScript ยท Tailwind CSS 4)           โ”‚
โ”‚  Landing ยท Dashboard ยท Earth View ยท AI Agents ยท Kessler ยท Coll  โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  API Layer  (Next.js API Routes)                                 โ”‚
โ”‚  /api/satellites  /api/debris  /api/collision-predictions        โ”‚
โ”‚  /api/ai/agent-pipeline  /api/simulations/kessler               โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  AI System  (LangGraph + Google Gemini / OpenAI)                 โ”‚
โ”‚  Debris โ†’ Orbit โ†’ Fuel โ†’ Mission โ†’ Commander                     โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚  Data  (MongoDB Atlas ยท Space-Track.org TLE data)                โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿค– AI Agent Workflow

 Threat Detected
      โ”‚
      โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  1. DEBRIS AGENT  ๐ŸŸก              โ”‚  Analyzes debris objects &
โ”‚     tracking & analysis          โ”‚  generates proximity report
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  2. ORBIT AGENT  ๐Ÿ”ต               โ”‚  Computes avoidance maneuvers,
โ”‚     trajectory & maneuver        โ”‚  checks secondary conjunctions
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  3. FUEL AGENT  ๐ŸŸข                โ”‚  Calculates ฮ”V cost, optimizes
โ”‚     propellant optimization      โ”‚  propellant usage
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  4. MISSION AGENT  ๐ŸŸฃ             โ”‚  Assesses mission impact,
โ”‚     continuity & operations      โ”‚  crew safety, comm windows
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  5. COMMANDER AGENT  ๐Ÿ”ท           โ”‚  Final decision authority,
โ”‚     synthesis & decision         โ”‚  generates maneuver command
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
    Autonomous Maneuver Command
         (< 10 seconds)

๐Ÿ› ๏ธ Tech Stack

Layer Technology Why
Framework Next.js 16 (App Router) Server components, API routes, Turbopack
Language TypeScript 5 (strict) Type safety across the entire codebase
Styling Tailwind CSS 4 Utility-first with CSS variable design tokens
3D Earth CesiumJS + Resium Industry-standard geospatial 3D globe
Animation Framer Motion (motion/react) Physics-based declarative animations
AI Pipeline LangGraph Multi-agent graph orchestration
AI Model Google Gemini / OpenAI GPT-4 State-of-the-art reasoning for space ops
Database MongoDB Atlas Flexible document storage for orbital data
Auth Firebase Auth Secure, scalable authentication
Deployment Vercel Zero-config Next.js deployment
Icons Lucide React Consistent, lightweight icon library
Fonts Orbitron ยท Space Grotesk ยท Inter ยท JetBrains Mono Aerospace identity typography

๐Ÿ“‚ Project Structure

spacesafexx/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”‚   โ”œโ”€โ”€ (app)/                    # Authenticated app routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ dashboard/            # Mission control dashboard
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ earth-view/           # 3D Earth visualization
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ai-agents/            # AI agent operations center
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ kessler-simulator/    # Cascade simulation
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ collision-engine/     # Collision prediction engine
โ”‚   โ”‚   โ”œโ”€โ”€ api/                      # Next.js API routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ satellites/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ debris/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ collision-predictions/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ai/
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agent-pipeline/
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ avoidance-maneuver/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ missions/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ simulations/kessler/
โ”‚   โ”‚   โ”œโ”€โ”€ globals.css               # Design system tokens
โ”‚   โ”‚   โ”œโ”€โ”€ layout.tsx                # Root layout + fonts
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx                  # Landing page
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ ui/                       # Core UI components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ button.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ card.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ badge.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ stat-card.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agent-card.tsx
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ progress.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ earth/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ earth-view.tsx        # CesiumJS component
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ earth-fallback.tsx    # CSS/SVG fallback
โ”‚   โ”‚   โ””โ”€โ”€ layout/
โ”‚   โ”‚       โ”œโ”€โ”€ navbar.tsx
โ”‚   โ”‚       โ””โ”€โ”€ footer.tsx
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ”œโ”€โ”€ utils.ts                  # Utility functions
โ”‚   โ”‚   โ”œโ”€โ”€ config.ts                 # App configuration
โ”‚   โ”‚   โ””โ”€โ”€ demo-data.ts              # Demo data generators
โ”‚   โ””โ”€โ”€ types/
โ”‚       โ””โ”€โ”€ index.ts                  # TypeScript definitions
โ”œโ”€โ”€ docs/
โ”‚   โ””โ”€โ”€ summary.md                    # Technical documentation
โ”œโ”€โ”€ screenshots/                      # Add your screenshots here
โ”œโ”€โ”€ public/                           # Static assets
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ tsconfig.json

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18.0 or higher
  • npm 9.0 or higher
  • MongoDB Atlas account (for production data)
  • Google Gemini API key or OpenAI API key

Installation

# Clone the repository
git clone https://github.com/omkar-103/spacesafexx.git
cd spacesafexx

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

Environment Variables

Create a .env.local file:

# Database
MONGODB_URI=mongodb+srv://username:[email protected]/spacesafexx

# AI (choose one or both)
GOOGLE_GEMINI_API_KEY=your_gemini_api_key_here
OPENAI_API_KEY=your_openai_api_key_here

# Firebase Authentication
FIREBASE_API_KEY=your_firebase_api_key
FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_STORAGE_BUCKET=your_project.appspot.com
FIREBASE_MESSAGING_SENDER_ID=your_sender_id
FIREBASE_APP_ID=your_app_id

# Space-Track.org (for real TLE data)
SPACE_TRACK_USERNAME=your_username
SPACE_TRACK_PASSWORD=your_password

# App Configuration
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_DEMO_MODE=true

๐ŸŽฌ Judge Mode

Judge Mode is a 60โ€“90 second automated guided experience that demonstrates the entire platform without any user interaction.

How to Activate

  1. Navbar โ€” Click โ–ถ JUDGE MODE button (always visible, top-right)
  2. Landing Page โ€” Click Watch Live Demo in the hero section
  3. Dashboard โ€” Click JUDGE MODE in the action bar
  4. Floating Button โ€” Always visible bottom-right on all pages

Demo Sequence

Step Duration What Happens
1 8s Earth telemetry lock โ€” scanning 34,247 tracked objects
2 10s Threat detected โ€” ISS ร— Fengyun-1C fragment conjunction
3 10s Collision prediction โ€” P(c), miss distance, ฮ”V computed
4 15s AI pipeline activates โ€” all 5 agents run sequentially
5 12s Avoidance maneuver ready โ€” fuel cost and confidence
6 15s Kessler cascade simulated โ€” 44 collisions prevented
7 12s Mission success โ€” final metrics displayed

โ˜๏ธ Deployment

Deploy to Vercel (Recommended)

# Install Vercel CLI
npm i -g vercel

# Deploy to production
vercel --prod

Or connect your GitHub repository to Vercel Dashboard for automatic deployments.

Set all environment variables under Settings โ†’ Environment Variables in your Vercel project.

Production Build

npm run build    # Build and type-check
npm start        # Start production server

๐ŸŽจ Design System

SpaceSafe X uses a bespoke aerospace design language:

Token Value Usage
Background #050816 App background (deep space)
Panel #0B1220 Card/panel surfaces
Border #172554 Hard engineering borders
Primary #00D4FF Actions, highlights, live data
Accent #7C3AED AI agents, secondary actions
Success #10B981 Nominal states
Warning #F59E0B Caution, moderate risk
Danger #EF4444 Critical threats

Typography: Orbitron (headings) ยท Space Grotesk (subheadings) ยท Inter (body) ยท JetBrains Mono (data)


๐Ÿ”ฎ Roadmap

  • Real TLE Integration โ€” Live data from Space-Track.org
  • CesiumJS Ion โ€” Photorealistic Earth with Bing satellite imagery
  • WebSocket Telemetry โ€” Sub-second live updates
  • Maneuver Uplink โ€” Direct satellite command integration
  • Multi-Satellite Scenarios โ€” Fleet-wide threat management
  • PDF Report Export โ€” Formatted mission reports with AI reasoning
  • Mobile App โ€” React Native companion

๐Ÿ† Hackathon

Built for the FAR AWAY International Hackathon 2026
Organized by Zuup

Challenge: Build an innovative MVP with real-world impact and technical depth.

Goal: Create an AI-powered autonomous space traffic management platform capable of preventing orbital collisions and mitigating Kessler Syndrome events.

Competition Journey

Round Stage Status
Round 1 Online MVP Submission โœ… Submitted
Round 2 Top 100 Teams โ€” Delhi Offline Hackathon ๐Ÿ† In Progress
Round 3 Top 5 Teams โ€” Grand Finale Japan ๐ŸŒŸ Target

SpaceSafe X was designed specifically to compete at the highest level of the FAR AWAY Hackathon and demonstrate how AI can help solve the growing orbital debris crisis โ€” a problem with genuine global consequences.


๐Ÿ‘จโ€๐Ÿ’ป Creator

Made with โค๏ธ by Omkar Parelkar

๐ŸŒ Portfolio omkarparelkar.com
๐Ÿ™ GitHub github.com/omkar-103
๐Ÿ’ผ LinkedIn linkedin.com/in/omkar-parelkar

Built for FAR AWAY 2026 by Zuup. Designed for the future of space.

SpaceSafe X โ€” Protecting Orbits. Ensuring Tomorrow.

About

AI-powered Space Traffic Management Platform that monitors orbital traffic, predicts satellite collisions, simulates Kessler Syndrome cascades, and generates autonomous avoidance maneuvers using a 5-agent AI system. Built with Next.js, CesiumJS, LangGraph, Gemini AI, and MongoDB.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages