开源AI工具：星座计算

Requirements

• Python 3.11 or higher
• All dependencies installed automatically (pyswisseph, pytz, geopy, rich, svgwrite)
• Note: On Python 3.12+, installing requires a C toolchain (until pyswisseph ships newer wheels)

Optional Dependencies

```bash

Installation

pip install stellium

Build a comprehensive terminal report

report = (ReportBuilder() .from_chart(chart) .with_chart_overview() # Chart metadata (date, location, zodiac system) .with_planet_positions(house_systems="all") # Positions with ALL house systems .with_declinations() # Declination table with OOB detection .with_house_cusps(systems="all") # House cusps for all systems .with_aspects(mode="major") # Major aspects table .with_aspect_patterns() # Grand Trines, T-Squares, Yods, etc. .with_dignities(essential="both")) # Essential dignities (traditional + modern)

report.render(format="rich_table") # Beautiful terminal output

Clone and install

git clone https://github.com/katelouie/stellium.git cd stellium pip install -e .

Visual Chart Example

Graphic Ephemeris Example

Quick Start

Progressive Examples

Example Cookbooks

The /examples directory contains comprehensive, runnable cookbooks:

```bash

User Guides

Quick Start

```bash

Run example cookbooks

python examples/chart_cookbook.py # Generate chart SVGs python examples/report_cookbook.py # Generate PDF reports python examples/comparison_cookbook.py # Generate synastry charts ```

Report Sample Pages

Stellium: composable, configurable, extensible

chart = (ChartBuilder.from_details("2000-01-06 12:00", "Seattle, WA") .with_house_systems([PlacidusHouses(), WholeSignHouses()]) # Multiple systems! .with_sidereal("lahiri") # Sidereal zodiac option .with_aspects(ModernAspectEngine()) # Swap aspect engines .with_orbs(LuminariesOrbEngine()) # Custom orb rules .add_component(ArabicPartsCalculator()) # Plugin-style components .add_component(MidpointCalculator()) # Stack as many as you want .calculate()) # Lazy evaluation ```

• Performance - Advanced caching system makes repeated calculations fast
• Flexibility - Calculate multiple house systems simultaneously
• Accuracy - Swiss Ephemeris provides planetary positions accurate to fractions of an arc-second
• Modern Python - Takes full advantage of Python 3.11+ features

---

Beautiful Visualizations, Zero Config

Want to customize your chart? The fluent .draw() API makes it effortless:

```python

2. Environment variable — no code changes required

export STELLIUM_EPHE_PATH=/opt/swisseph/ephe # macOS / Linux set STELLIUM_EPHE_PATH=D:\swisseph\ephe # Windows (cmd) $env:STELLIUM_EPHE_PATH = "D:\swisseph\ephe" # Windows (PowerShell) ```

When you supply a custom path Stellium uses it as-is: the folder is not created, and the bundled ephemeris files are not copied into it. Make sure it already contains every .se1 file you need for the objects and date range you plan to calculate.

---

Lists of Implemented Options

• See the full documentation list

Command-Line Interface

Stellium includes a CLI for quick chart generation:

```bash

Level 4: Arabic Parts & Components

```python from stellium import ChartBuilder from stellium.components import ArabicPartsCalculator, MidpointCalculator

chart = (ChartBuilder.from_details("2000-01-06 12:00", "Seattle, WA") .add_component(ArabicPartsCalculator()) .add_component(MidpointCalculator()) .calculate())

- Component results (Arabic Parts, midpoints, etc.)

Data Analysis (pandas Integration)

Batch calculate charts and analyze with pandas DataFrames:

```python from stellium.analysis import BatchCalculator, ChartStats, charts_to_dataframe

Comparison Charts (Bi-Wheels)

Create relationship, timing, and synthesis charts:

```python from stellium import MultiChartBuilder, Native, SynthesisBuilder