asterwise-python

The official Python library for Asterwise — Vedic + Western astrology, numerology, tarot, crystals, and dreams. 115+ endpoints. Ships in days.

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

Domain	Operations
Vedic astrology	40
Matchmaking	5
Western astrology	17
Horoscope	8
Numerology	24
KP + Lal Kitab	5
Tarot	9
Crystals & dreams	7
Utilities	2

117 typed SDK methods across 13 API classes; marketed as 115+ 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 100+ 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.