monster/nategodd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1be39727f8
nategodd/README.md
type-two 1be39727f8 NATEGODD: Swiss Ephemeris natal chart generator 
Full-detail natal charts: 21 bodies/points, 7 house systems, 11 aspect
types with applying/separating, dignities, declination parallels,
sect/balances/moon phase, offline city search with historical IANA
time atlas, SVG wheel, and a written interpretation report.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-30 19:52:08 +10:00

2.0 KiB
Raw Blame History

NATEGODD

Natal chart generator in the spirit of the great 90s desktop astrology programs (Win*Star / Solar Fire era) — full detail, real ephemeris, written report.

What it does

  • Swiss Ephemeris computation (bundled ephe/ files, valid 1800–2400 AD): Sun–Pluto, Chiron, Ceres, Pallas, Juno, Vesta, True North/South Node, Mean Lilith, Part of Fortune, Vertex, ASC/MC/DSC/IC.
  • Historical time atlas: offline city search (25k cities via geonamescache), timezonefinder + IANA tzdata for correct historical offsets and DST (wartime double summer time and all). Manual lat/lon/offset override available.
  • 7 house systems: Placidus, Koch, Whole Sign, Equal, Porphyry, Campanus, Regiomontanus.
  • Aspects: 11 aspect types with per-body orbs, luminary bonus, applying/separating, triangular aspect grid, declination parallels/contraparallels.
  • Detail: retrogrades, essential dignities (domicile/exaltation/detriment/fall), element/modality/polarity balances, day/night sect, moon phase + illumination.
  • Interpretation report: hand-written Big Three texts (Sun/Moon/Rising × 12) plus a keyword-synthesis engine for every planet-in-sign, planet-in-house and aspect. Printable.
  • Time unknown mode: casts a noon solar chart, drops houses/angles honestly.
  • SVG chart wheel (element-tinted zodiac ring, houses, aspect lines, collision-spread glyphs), saved charts in localStorage.

Run

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python app.py

Open http://localhost:7799.

Layout

  • chart.py — ephemeris computation engine
  • geo.py — city search + historical timezone resolution
  • interp.py — interpretation texts + synthesis engine
  • app.py — Flask server (/api/search, /api/chart)
  • static/ — single-page frontend (vanilla JS, SVG wheel)
  • ephe/ — Swiss Ephemeris data files (sepl/semo/seas 1800–2400)

Ephemeris data files are from the official Swiss Ephemeris distribution (AGPL, astro.com / github.com/aloistr/swisseph).