Skip to content

README.md

Latest commit

 

History

History
147 lines (114 loc) · 9.13 KB

README.md

File metadata and controls

147 lines (114 loc) · 9.13 KB
Raw

Asase Earth Intelligence

Global Earth Intelligence & Multi-Hazard Planetary Defense Platform

Live Web App Google Play Store Windows EXE Linux DEB Linux RPM Flet Python

📥 Download

Platform Package Description
🌐 Web App Live Web App Live progressive web application running directly in your browser
🤖 Android Play Store Recommended for Android mobile and tablet devices
🪟 Windows Windows Release Standalone Inno Setup installer with taskbar & desktop integration
🐧 Linux (Debian/Ubuntu) Linux DEB Native desktop package for Ubuntu, Debian, Linux Mint & Pop!_OS
🎩 Linux (Fedora/RHEL) Linux RPM Native package for Fedora, openSUSE, RHEL & CentOS
📦 Linux (Universal) Linux TAR.GZ Standalone portable archive for Arch, Alpine, Steam Deck & all distros

Android Architecture Build Splits

Variant Download Device Compatibility
📱 ARM64 (v8a) asase-arm64-v8a.apk Modern 64-bit Android smartphones & tablets
📱 ARMv7 (32-bit) asase-armeabi-v7a.apk Legacy 32-bit Android devices
💻 x86_64 (Emulators) asase-x86_64.apk ChromeOS, Chromebooks & Android desktop emulators

🌍 Core Capabilities

Capability Telemetry Source Description
Seismic Hazards USGS FDSN Real-time global earthquake feeds with Richter magnitude, depth, tsunami warnings, and geodesic shockwave radius.
Space Weather & $K_p$ NOAA SWPC Planetary $K_p$-index geomagnetic disturbance monitor with 12-reading live progression curves.
Solar Radiation NOAA GOES Primary Real-time satellite solar X-ray flux and flare classification (A, B, C, M, X class).
Atmospheric & Storms Open-Meteo Forecast Hyperlocal temperature, surface pressure, extreme wind gusts, UV index, and CAPE thunderstorm potential.
Air Quality Spectrum Open-Meteo AQI European AQI, US AQI, $\text{PM}{2.5}$, $\text{PM}{10}$, Carbon Monoxide ($\text{CO}$), Ozone ($\text{O}_3$), $\text{NO}_2$, $\text{SO}_2$, and Saharan dust.
GloFAS Hydrology Copernicus / GloFAS Global river discharge forecasting ($m^3/s$) and 7-day hydrological flood progression.
Marine Swell Dynamics Open-Meteo Marine Ocean wave height, period, direction, and coastal swell surge risks.
Planetary Disasters NASA EONET v3 Satellite thermal anomaly tracking for active wildfires, severe storms, volcanoes, and sea ice.

📸 Screenshots

Radar Dashboard

Radar Dashboard — light mode

Radar Dashboard — elevation, temperature, AQI & Kp-index chips for your pinned location, nearest-hazard warning, one-tap full dossier, and the live global hazard radar below

Global place search

Typeahead geocoding — search any city, region, or coordinate with live elevation and lat/lon results

Live Hazard Feeds

Recent seismic activity Expanded wildfire event detail
Recent seismic activity — USGS 24h feed with magnitude, depth, MMI, severity badges, and distance-from-you chips Tap a wildfire to expand inline — coordinates, view full dossier, share, and source attribution

Global Hazard Map

Global hazard map — satellite view Selected earthquake on the map
Satellite basemap with wildfire, seismic, and flood markers, proximity shockwave rings, and the AI Scan action Tap any marker to inspect the event — magnitude, depth, and one-tap full dossier right on the map

Space Weather & Location Intelligence

Space weather Kp-index and solar flux charts Location risk dossier with AI briefing
Space weather — NOAA Kp-index with 12-reading progression and GOES solar X-ray flux live charts Location risk dossier — safety score, 5-axis multi-hazard threat radar, and the Kiri Intelligence AI briefing

✨ Features

  • 100% Free & Auth-Free — Zero API keys required. Direct client connections to official open public domain planetary telemetry endpoints.
  • Watermark-Free Esri Dark Gray Map — Auth-free Esri Dark Gray Canvas tiles with OpenStreetMap fallback and interactive shockwave circles.
  • Instant Reactive Theme Mode Switcher — Real-time switching between Light ☀️, Dark 🌙, and System 🖥️ modes across all screens with transparent vector branding.
  • Hardware-Accelerated Charts — Live geomagnetic curves and multi-axis planetary threat radar charts with flet-charts.
  • Proximity Geodesic Engine — Haversine distance engine warning users of nearest active hazards (e.g. "142 km from you").
  • Offline Telemetry Caching — L1 LRU Memory + L2 Gzip Disk caching (.json.gz) with atomic swaps and corruption recovery.
  • Live Activity Terminal — Real-time event and connection logging with one-tap clipboard copy and diagnostic inspection.
  • Native Sharing & Links — 1-tap report sharing via ft.Share and official agency deep linking via ft.UrlLauncher.
  • Monetization & Privacy — Responsive Google AdMob banners and interstitial ads with consent management.

🛠️ Development & Testing

# Install dependencies with uv
uv sync --dev

# Run linter & formatter checks
uv run ruff check . --fix
uv run ruff format .

# Run comprehensive test suite (51 tests)
uv run pytest -v

# Start local desktop development server
uv run flet run

🧭 License

MIT License © 2026 Kiri Research Labs. All planetary telemetry sourced from open public-domain science organizations (USGS, NOAA, NASA, Copernicus & Open-Meteo).