asterwise-python

The official Python library for Asterwise — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 118 endpoints, generated from the API's OpenAPI document so the types match what the server sends. Every position is checked against NASA JPL Horizons, median 0.046 arcseconds over 80 positions from 1950 to 2050.

Documentation · API Reference · Pricing · MCP server

Installation

pip install asterwise

Quickstart

import asterwise
from asterwise.api.astrology_api import AstrologyApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.natal_chart(
        asterwise.NatalRequest(
            date="1985-11-12",
            time="06:45",
            location="Mumbai, India",
            ayanamsa="lahiri",
        )
    )
    print(result)

Get a free API key at asterwise.com.

What you can build

118 typed SDK methods across 13 API classes covering 118 REST endpoints.

What makes Asterwise different

• Structured classical interpretations on every response
• 5-level Vimshottari Dasha (Maha → Antar → Pratyantar → Sookshma → Prana) — most APIs return two
• Rajju and Vedha as hard vetoes in matchmaking — not just point scores
• HMAC-signed responses for auditability
• MCP server with 103 tools for Claude and Cursor integration

Examples

from datetime import date
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.api.numerology_api import NumerologyApi
from asterwise.api.tarot_api import TarotApi

with asterwise.ApiClient(configuration) as client:
    western = WesternAstrologyApi(client)
    chart = western.western_natal_chart(
        asterwise.WesternNatalRequest(
            date="1985-11-12",
            time="06:45",
            location="Mumbai, India",
        )
    )

    numerology = NumerologyApi(client)
    path = numerology.life_path(var_date=date(1985, 11, 12))

    tarot = TarotApi(client)
    spread = tarot.tarot_three_card(
        asterwise.SpreadRequest(question="What should I focus on this month?")
    )

Requirements

Python 3.9+. An API key from asterwise.com.

Documentation

Full API reference: docs.asterwise.com

Development

Regenerate from https://api.asterwise.com/openapi-sdk.json (see asterwise-api/_docs/SDK_CONTRACT.md).

Requirements: Node.js/npm (for npx), Java 11+ for OpenAPI Generator.

bash scripts/generate.sh

Versioning: regenerate → bump version in pyproject.toml and asterwise/__init__.py → update CHANGELOG.md → python -m build → publish with twine upload.

Support

support@asterwise.com

License

Commercial. See LICENSE.