A traditional (Hellenistic and Medieval) astrology engine. It computes natal and mundane charts with the Swiss Ephemeris and applies classical interpretation techniques drawn from sources including Valens, Ptolemy, Dorotheus, Bonatti, and Ibn Ezra.
Live demo: traditional-astrology.com
Historical and symbolic use only. This software does not provide medical, financial, legal, or safety advice. See the disclaimer at the end.
- Traditional synthesis: dignity/debility, sect, aspect geometry, and narrative chart synthesis.
- Almuten Figuris: Ibn Ezra 12-point house scoring, plus the seven Hermetic Lots with sect-based reversal.
- Report CLI: a single entry point for generating a full chart report (
src/scripts/generate_premium_report.py). - Condition audits: besiegement, combustion/cazimi, and maltreatment (Kakosis) checks applied to each placement.
- Soul Guardian (Almuten Figuris): Detailed scoring based on Ibn Ezra's traditional protocols.
- Hermetic Lots: Full implementation of the 7 Hermetic Lots with sect-based vector reversal.
- Constitutional Fitness: Complete Sect, Hayz, and Halb filtering.
- Accidental Strength: Combustion/Cazimi, Besiegement, Speed, and House Placement (Whole Sign/Placidus/Regiomontanus).
- Shadow Physics: Implementation of Antiscia and Contra-antiscia reflection.
- Chronocrators: Firdaria periods, Profections (Annual/Monthly), and Zodiacal Releasing (Level 3).
- Time Lord Auditing: Integrated historical timeline generation.
- Eclipse Sophistication: Quadrant-based timing of intensification and chorography (geographic impact).
- Great Conjunctions: Historical tracking of Jupiter-Saturn cycles.
- Ingress Overrides: Aries Ingress (Rank 4) logic overriding natal promises.
- Surgery Advisory: Real-time safety auditing avoiding Eclipses, Critical Days, and Lunar sign conflicts.
- Crisis Timing: 7, 14, and 21-day "Crisis in Consciousness" progression.
- Python 3.10+
pyswisseph(Swiss Ephemeris Python bindings)fastapi&uvicorn
- Clone the repository and initialize a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate
- Install dependencies:
pip install -r requirements.txt
Generate technical JSON data and a narrative Markdown report:
python src/scripts/generate_premium_report.py --name "Alexander Hamilton" --date "1755-01-11" --time "12:00" --city "Charlestown" --state "MA"The API is self-documenting via FastAPI:
uvicorn src.app:app --reload- Swagger UI: http://127.0.0.1:8000/docs
src/engine/: Core algorithmic logic.src/database/data/: Ingested codex delineations (JSON).src/static/: Premium Glassmorphic UI.
MIT License. See LICENSE for details.
Portions of this software deal with historical medical astrology (Iatromathematics). This content is provided for historical and educational research purposes only. It is NOT medical advice. Under no circumstances should any information provided by this software be used to make health decisions or schedule medical procedures. Always consult a qualified medical professional for health concerns.