Satellite Oracle Svelte

The skies are busy, we prosper.

Getting Started

Prerequisites

• A free account at space-track.org
• OpenAI API Key

Setup Instructions

1. Clone the repository

2. Create a .env file by copying the example:

   cp .env.example .env
   

3. Fill in your credentials in the .env file:

   • EMAIL: Your space-track.org account email
   • PASSWORD: Your space-track.org password
   • OPENAI_API_KEY: Your OpenAI API key

4. Start the application:

   npm i
   npm run dev
   

The application should now be running and accessible through your web browser.

Raspberry Pi deployment (Docker + Cloudflare Tunnel)

1. Ensure your .env file contains the existing credentials plus:
   • CLOUDFLARED_TUNNEL_TOKEN – generated in the Cloudflare Zero Trust dashboard
   • (optional) APP_BASE_PATH – override if /satellite-oracle is not desired.
2. docker compose build --pull
3. docker compose up -d
4. Point the Cloudflare tunnel hostname phlreich.com at the tunnel and origin service http://localhost:80.

What the stack looks like

• app – the SvelteKit server is now aware that it lives at /satellite-oracle, so assets and API calls resolve correctly underneath that prefix.
• nginx – serves the lightweight landing page for phlreich.com from webroot/phlreich and proxies /satellite-oracle/* back to the Svelte app.
• cloudflared – runs alongside nginx, terminating TLS at Cloudflare so no origin certificates are required. If you need end-to-end TLS you can swap in a Certbot container and mount generated certs into nginx.

Traffic to the legacy satellite-oracle.com host is automatically redirected to https://phlreich.com/satellite-oracle.

Customize the landing page by editing the files under webroot/phlreich.

Application Overview

Once the application is running, you will see a visualization of the Earth with human-made objects orbiting it in real time. This provides a dynamic view of satellites and other objects in space.

Using the Chat Interface

The application includes a chat interface that allows you to filter and interact with the objects in orbit. You can use natural language queries to filter the objects based on various criteria. For example, you can type:

• "Show me all objects launched by NASA in 2020"

This will filter the displayed objects to only those that match your query, providing a powerful tool for exploring the data.