Skip to content

Stellium 0.2.0

Choose a tag to compare

@katelouie katelouie released this 26 Nov 21:18
· 283 commits to main since this release

Stellium 0.2.0 — The "Actually, Let's Do This Properly" Release

A complete architectural overhaul and massive feature expansion.

This release rebuilds Stellium from the ground up with a protocol-driven, composable architecture. If 0.1.0 was "it works," 0.2.0 is "it works and it's built to grow."

Highlights

New Chart Types

  • Synastry — relationship compatibility charts with biwheel visualization
  • Transits — natal vs. current sky
  • Progressions — secondary progressions
  • Composite & Davison — relationship synthesis charts

Beautiful Visualization

  • 13 themes with customizable zodiac palettes and aspect colors
  • Multi-house system rendering — see Placidus and Whole Sign on the same wheel
  • Biwheel charts for all comparison types
  • Moon phase display in chart center or corners
  • Header bands with native info, location, datetime

Professional Reports

  • PDF export via Typst — gorgeous, print-ready reports
  • Rich terminal output — beautiful tables in your console
  • New sections: dignities, aspect patterns, house cusps, multi-system planet positions
  • Graceful error handling with helpful "how to fix this" messages

Architecture Overhaul

  • Protocol-driven design — extend with custom engines, no inheritance required
  • Fluent builder API — chainable, readable, composable
  • Comprehensive registries — 61 celestial objects, 17 aspect types, all with metadata
  • Multiple house systems simultaneously — calculate once, compare everywhere
  • Rebranding — rename from starlight

Installation

pip install stellium

Quick Start

from stellium import ChartBuilder

# Two lines to a beautiful chart
chart = ChartBuilder.from_notable("Albert Einstein").with_aspects().calculate()
chart.draw("einstein.svg").with_theme("celestial").save()

📖 Full Changelog

See CHANGELOG.md for the complete list of additions, changes, and fixes.

What's Next

  • More notables in the database
  • Sidereal/Vedic support (in progress)
  • Returns (solar, lunar)
  • Declinations and parallels
  • Even more report sections

Named after the astrological term for a cluster of planets—and after a rather prominent feature in the author's own natal chart.