myastroboard/myastroshine repository overview

⁠🔭 MyAstroShine

A self-hosted astronomical image processing tool - enhancement, multi-image stacking, and depth effects.

MyAstroShine automatically enhances astrophotography images, aligns and stacks 2-2000 frames to raise signal-to-noise, and adds a parallax "Depth Shift" effect - all from one Docker image, no account or cloud upload required. It integrates optionally with MyAstroBoard⁠'s Astrodex but also runs entirely standalone.

⁠✨ Features

• Automatic enhancement - contrast, clarity, noise reduction, dynamic stretching, dehaze, gradient and vignette correction, in a workflow-ordered editor with inline help
• One-click Auto Astro - analyses the image and applies an adaptive starting point; plus five built-in presets and your own
• Tone + colour curves - an interactive master RGB curve and independent red / green / blue curves
• Star handling - shrink stars in place, or lift them out entirely (starless workflow) and blend them back at the end
• Geometry tools - rotate, flip, straighten, and crop before the pixel pipeline runs
• Depth Shift - a parallax effect that adds a sense of 3D depth to a single frame
• Stacking - align and combine 2-2000 linear frames (calibration, per-frame quality scoring, asterism-matching registration, sigma-clip combination, optional drizzle) to raise SNR
• Optional ML engines - point it at an operator-installed StarNet2 / DeepSNR binary (nothing bundled)
• FITS / camera RAW / 16-bit upload support, plus edit milestones and a folder-watch stacking mode
• English + French UI, light / dark themes
• Astrodex integration - capture in Astrodex, enhance here, send back via a signed webhook
• Standalone workflow - manual upload, edit, download - no other MyAstroBoard component required

⁠🚀 Quick Start

docker pull myastroboard/myastroshine:latest

One container is the whole application (web UI, API and background processing):

docker run -d -p 8002:8002 -e APP_ENV=production \
  -v myastroshine_data:/data myastroboard/myastroshine:latest

Or with Docker Compose:

services:
  api:
    image: myastroboard/myastroshine:latest
    ports:
      - "8002:8002"
    environment:
      - APP_ENV=production
    volumes:
      - myastroshine_data:/data
    restart: unless-stopped
volumes:
  myastroshine_data:

The full docker-compose.yml (with healthchecks and comments) is in the repository⁠. No .env editing required - everything tunable (CORS, upload limits, stacking defaults, log levels, ...) is edited from Settings in the UI and persisted under the data volume. See the Deployment Guide⁠.

⁠🐳 Available Tags

⁠🖥️ Supported Platforms

⁠📋 Requirements

• Docker (Compose recommended for the queued-processing setup)
• Linux host or compatible Docker environment

⁠📚 Documentation

• Documentation index⁠
• Features⁠
• Deployment Guide⁠
• Troubleshooting⁠
• API Reference⁠
• Contributing⁠
• Security Policy⁠

⁠🐛 Support

Issues and feature requests: GitHub Issues⁠

⁠📄 License

Licensed under AGPL-3.0-or-later⁠. Source code available at: github.com/myastroboard/myastroshine⁠