ECLIPSE is a feature-rich Python CLI that turns your terminal into a space exploration platform. Fetch NASA imagery, track the ISS, browse upcoming rocket launches, query a planetary database, and ask an AI space assistant — all without leaving the command line.
- Python 3.10+
- A NASA API key (free at api.nasa.gov) — optional,
DEMO_KEYworks with a rate limit - An Anthropic API key (from console.anthropic.com) — required only for
eclipse ask
git clone <repo>
cd eclipse
cp .env.example .env
# Edit .env and add your NASA_API_KEY and ANTHROPIC_API_KEY
pip install -e .After install, the eclipse command is available globally.
Display NASA's Astronomy Picture of the Day.
🌑 ECLIPSE · Space Intelligence Terminal
┌────────────── 🌌 Astronomy Picture of the Day ──────────────┐
│ Earth at Twilight │
│ 2026-06-14 │
│ │
│ No sudden, sharp boundary marks the passage of day... │
│ │
│ HD Image │
└──────────────────────────────────────────────────────────────┘
Live position and crew of the International Space Station.
🌑 ECLIPSE · Space Intelligence Terminal
┌────────── 🛰 Live Feed — International Space Station ──────────┐
│ Metric Value │
│ Latitude -51.2345 │
│ Longitude 123.4567 │
│ Altitude 408 km │
│ Speed 27,600 km/h │
│ Crew aboard Jane Doe, John Smith │
└────────────────────────────────────────────────────────────────┘
Upcoming rocket launches from the Space Devs API.
🌑 ECLIPSE · Space Intelligence Terminal
┌────────────────── 🚀 Upcoming Rocket Launches ──────────────────┐
│ Mission Rocket Date (UTC) Launch Site Status │
│ Artemis II SLS Block 1 June 18, 2026 Kennedy LC-39B Go │
└─────────────────────────────────────────────────────────────────┘
Persistent table of active space missions stored in SQLite.
🌑 ECLIPSE · Space Intelligence Terminal
┌──────────────────── 🛰 Active Space Missions ───────────────────┐
│ Mission Agency Launch Year Status Description │
│ James Webb NASA/ESA 2021 Active ... │
└─────────────────────────────────────────────────────────────────┘
Information about planets and major bodies.
🌑 ECLIPSE · Space Intelligence Terminal
┌────────────────── 🔴 MARS ──────────────────┐
│ │
│ Gravity 3.721 m/s² │
│ Moons 2 (Phobos, Deimos) │
│ Diameter 6,779 km │
│ Distance 227.9M km from Sun │
│ Day Length 24h 37m │
│ Year Length 687 Earth days │
│ Atmosphere Thin CO₂ (95%) │
│ │
│ 💡 Olympus Mons is the tallest volcano │
│ in the solar system at 21.9 km. │
└─────────────────────────────────────────────┘
A random astronomy fact.
🌑 ECLIPSE · Space Intelligence Terminal
┌────────────────── 🌌 Cosmic Fact ──────────────────┐
│ A teaspoon of neutron star material would weigh │
│ about 6 billion tons on Earth. │
└────────────────────────────────────────────────────┘
Ask the ECLIPSE AI assistant a space question.
eclipse ask "How long does it take to get to Mars?"🌑 ECLIPSE · Space Intelligence Terminal
┌────────────────── 🌌 ECLIPSE ──────────────────┐
│ Depending on the trajectory and planetary │
│ alignment, a trip to Mars takes approximately │
│ 7 to 9 months using current propulsion. │
│ The 2020 Perseverance mission took 7 months. │
└──────────────────────────────────────────────────┘
- NASA: Sign up for a free key at https://api.nasa.gov
- Anthropic: Get a key at https://console.anthropic.com
Copy .env.example to .env and fill in your keys before running commands that need them.