Aspectarian is a personal Vedic astrology (Jyotiṣa) transit reading app, focused on long-term outer-planet changes. Its repository description is "personal Jyotiṣa aspect reader tuned for long-term outer-planet changes".
Main capabilities:
- After entering a birth chart once, it calculates currently active transit contacts using Parāśaran dṛṣṭi and yuti (sign-based, without orbs).
- Generates interpretations via Claude.
- Provides a 30-day calendar, Vimśottarī daśā display, transit duration indicators, and aṣṭakavarga-based interpretations.
Runtime environment and prerequisites:
- macOS (tested on macOS 12+, Intel and Apple Silicon).
- Python 3.12 or later (download from python.org).
- Anthropic API key (obtain from console.anthropic.com).
- Xcode Command Line Tools (required to compile system libraries). The installation script automatically checks and opens the installer if needed; you can also run xcode-select --install in Terminal in advance to install it.
Installation and startup method:
- Extract the archive, open Terminal in the folder: cd path/to/Aspectarian.
- Run the installation script (creates a virtual environment and installs all dependencies): sh setup.sh. The first run takes about a minute, and you will see "Setup complete" when finished.
- Then open in your browser http://localhost:7842。
On first launch, you will enter a setup wizard and fill in the following in order:
- Name: display name.
- API key: Anthropic API key (securely stored in macOS Keychain, never written to disk).
- Birth data: date of birth, time (UTC), and place of birth.
- Preferences: default reading window, language, theme. After setup is complete, Aspectarian will directly open your transit reading.
Settings: All settings have reasonable defaults and can be overridden by setting environment variables before running. For example, you can run on a different port (official materials do not provide the specific environment variable names, so they are not provided here).
Data and privacy:
- All calculations run locally: ephemeris, contacts, daśā, aṣṭakavarga.
- Birth data and reading history are stored in aspectarian.db (SQLite, local only).
- The API key is stored in macOS Keychain via the system keyring.
- Transit readings are sent to the Anthropic API (Claude) for generating interpretations; aside from standard API logs, Anthropic does not store data.
Stopping the server: Press Ctrl-C in the Terminal window where ./run.sh is running.
Use cases: Suitable for macOS users who want to manage birth data locally and use Claude to obtain Vedic astrology transit interpretations, especially those concerned with long-term outer-planet changes.
Limitations: Official materials do not provide details such as pricing, license, non-macOS platform support, or support for other languages, so they are not provided here.
