{"slug": "aspectarian-a-jyotisa-transit-reader-for-macos-using-claude", "title": "Aspectarian – a Jyotiṣa transit reader for macOS using Claude", "summary": "Aspectarian, a personal Vedic astrology transit app for macOS, uses Claude to generate interpretations of active transit contacts based on a user's natal chart. The app computes Parāśaran dṛṣṭi and yuti with sign-based aspects, includes a 30-day calendar, Vimśottarī daśā display, and aṣṭakavarga-informed readings, all running locally with the Anthropic API for LLM interpretation.", "body_md": "A personal Vedic astrology transit app. Enter your natal chart once; Aspectarian computes active transit contacts using Parāśaran dṛṣṭi and yuti (sign-based, no orbs) and generates an interpretation via Claude. Includes a 30-day calendar, Vimśottarī daśā display, transit duration indicators, and aṣṭakavarga-informed readings.\n\n**macOS**(tested on macOS 12+, Intel and Apple Silicon)** Python 3.12 or later**— download from[python.org](https://www.python.org/downloads/)** Anthropic API key**— get one at[console.anthropic.com](https://console.anthropic.com)** Xcode Command Line Tools**— required to compile system libraries. The setup script checks for this automatically and opens the installer if needed. You can also install in advance by running`xcode-select --install`\n\nin Terminal.\n\n-\nUnzip the archive and open Terminal inside the folder:\n\n```\ncd path/to/Aspectarian\n```\n\n-\nRun the setup script (creates a virtual environment and installs all dependencies):\n\n```\nsh setup.sh\n```\n\nThis takes about a minute on first run. You will see \"Setup complete\" when it finishes.\n\n```\n./run.sh\n```\n\nThen open ** http://localhost:7842** in your browser.\n\nOn first launch, you will be taken through the setup wizard:\n\n**Name**— your display name** API key**— your Anthropic API key (stored securely in macOS Keychain; never written to disk)** Birth data**— date, time (UTC), and place of birth** Preferences**— default reading window, language, theme\n\nAfter setup, Aspectarian opens directly to your transit reading.\n\n| Path | Contents |\n|---|---|\n`engine/` |\nEphemeris computation, contacts, daśā, aṣṭakavarga, calendar |\n`context/` |\nSystem prompt assembly, symbol map |\n`session/` |\nLLM client, NDJSON streaming, reading storage |\n`reports/` |\nDay / week / month report logic |\n`storage/` |\nSQLite models and async queries |\n`ui/` |\nFastAPI app + Vanilla JS frontend |\n`ephemeris/ephe/` |\nSwiss Ephemeris data files (required) |\n`data/` |\nGeoNames city database for birth place search |\n`symbol_map.json` |\nJyotiṣa interpretation framework |\n`config.py` |\nAll configuration (overridable via env vars) |\n\nAll settings have sensible defaults. Override by setting environment variables before running:\n\n| Variable | Default | Description |\n|---|---|---|\n`CLAUDE_MODEL` |\n`claude-sonnet-4-6` |\nAnthropic model |\n`CLAUDE_MAX_TOKENS` |\n`8192` |\nMax output tokens per reading |\n`PORT` |\n`7842` |\nLocal server port |\n`HOST` |\n`127.0.0.1` |\nBind address (localhost only) |\n`DB_PATH` |\n`aspectarian.db` |\nPath to user database |\n`HISTORY_MAX_READINGS` |\n`5` |\nPast readings included in LLM context |\n\nExample — run on a different port:\n\n```\nPORT=8080 ./run.sh\n```\n\n- All computation runs locally — ephemeris, contacts, daśā, aṣṭakavarga.\n- Your birth data and reading history are stored in\n`aspectarian.db`\n\n(SQLite, local only). - Your API key is stored in macOS Keychain via the system keyring.\n- Transit readings are sent to the Anthropic API (Claude) for interpretation. No data is stored by Anthropic beyond standard API logging.\n\nPress `Ctrl-C`\n\nin the Terminal window running `./run.sh`\n\n.", "url": "https://wpnews.pro/news/aspectarian-a-jyotisa-transit-reader-for-macos-using-claude", "canonical_source": "https://github.com/SpecStudio-net/Aspectarian", "published_at": "2026-06-16 02:00:24+00:00", "updated_at": "2026-06-16 02:18:17.271996+00:00", "lang": "en", "topics": ["large-language-models", "ai-tools", "ai-products"], "entities": ["Aspectarian", "Claude", "Anthropic", "macOS", "Python", "Swiss Ephemeris", "GeoNames", "SQLite"], "alternates": {"html": "https://wpnews.pro/news/aspectarian-a-jyotisa-transit-reader-for-macos-using-claude", "markdown": "https://wpnews.pro/news/aspectarian-a-jyotisa-transit-reader-for-macos-using-claude.md", "text": "https://wpnews.pro/news/aspectarian-a-jyotisa-transit-reader-for-macos-using-claude.txt", "jsonld": "https://wpnews.pro/news/aspectarian-a-jyotisa-transit-reader-for-macos-using-claude.jsonld"}}