synastry

Python>=3.13 CLI for analyzing astrological partner chart data.

features

• aspect calculation – computes major by-sign aspects (conjunction, sextile, square, trine, opposition) between sun and moon placements.
• frequency analysis – counts distribution of house placements and sun signs.
• generates pie and bar charts showing:
  • partner sun placements in the subject's houses
  • partner sun signs
  • sun-sun aspects
  • moon-sun aspects
• cli-first – accepts CSV input files and optional figure titles.
• automatic output – saves enriched CSV files and figures in a timestamped output/ directory.

installation & usage

# build from source
curl -LO https://beguine.nekoweb.org/src/synastry-0.1.0.tar.gz
tar -xf synastry-0.1.0.tar.gz && cd synastry-0.1.0
uv sync
uv run synastry <csvfile> --title "test"

• <csvfile> – input CSV file with columns ['asc', 'sun', 'moon', 'partner sun', 'partner house']
• --title – optional argument to set a custom title for the figure and stdout

output files are saved in output/:

• enriched CSV: data_YYYYMMDD-HHMMSS.csv
• enriched XLS: data_YYYYMMDD-HHMMSS.xlsx
• figure: figure_YYYYMMDD-HHMMSS.png

filetree

.
├── LICENSE
├── PKG-INFO
├── README.md
├── pyproject.toml
├── setup.cfg
├── synastry
│   └── main.py
└── synastry.egg-info
    ├── PKG-INFO
    ├── SOURCES.txt
    ├── dependency_links.txt
    ├── entry_points.txt
    ├── requires.txt
    └── top_level.txt

download

synastry-0.1.0.tar.gz