Astro Skill is a production-grade, deterministic Vedic astrology engine that converts birth information and celestial coordinates into structured mathematical charts, timelines, and factual reports. The project is positioned as an open-source Vedic astrology engine, agent skill, and MCP server, emphasizing computation-driven rather than generative guesswork.
In terms of use, it is aimed at developers, astrologers, consulting agencies, and consumer applications that need high-precision, reproducible Vedic astrology calculations. Its core goal is to transform astrology calculation from relying on external APIs or free generation by large models into deterministic mathematical calculation based on the Swiss Ephemeris, thereby avoiding hallucinations.
Main capabilities include: high-precision calculations using bundled Swiss Ephemeris data (.se1 SWIEPH, via pyswisseph) and Lahiri (Chitrapaksha) ayanamsa; support for kundali, Vimshottari dasha, panchang, gochar and Sade Sati, ashtakavarga, guna milan, divisional charts, and Hindi janma patrika PDF, etc. Report generation is completed in-process with ReportLab, supports bilingual Hindi and English Kundali and Panchang charts, and bundles the Noto Sans Devanagari font, without relying on a headless browser or Chrome. The project claims to be 100% offline, with zero API keys and zero rate limits, and no network calls are required for astrology calculations.
Usage provides three plug-and-play interfaces: first, a Stdio MCP server (astro-mcp), exposing 11 stable tools, suitable for Claude Desktop, Cursor, Codex, OpenClaw, and any Model Context Protocol client, with built-in SQLite client profile management and report generation; second, a Python library and CLI, which can be imported directly in Python, or run a standalone CLI calculation script and output --json; third, Agent Skill, providing a portable SKILL.md for equipping autonomous coding agents and orchestrators. For installation, it can be installed from PyPI and requires Python 3.11+.
Applicable scenarios include: providing astrology calculation tools for MCP clients; integrating Vedic astrology calculations in Python projects; quickly generating JSON results through the CLI; providing astrology skills for autonomous agents; generating bilingual Kundali and Panchang PDF reports.
Limitations and boundaries: the project explicitly requires that reports are a mathematical baseline and should be reviewed by an astrologer or operator before being shared; birth time or place must not be guessed or synthesized, and users should be prompted when input is missing; fatalistic assertions, death timing, medical diagnoses, or predictions of inevitable harm are strictly prohibited. In addition, the repository contains the open-source core deterministic engine, namely mathematical calculations, structured JSON schema, and factual ReportLab PDFs; the Pro Report Tier for astrologers, consulting agencies, and consumer applications provides Pandit-level LLM synthesis, advanced print layout, and prioritized actionable remedial suggestions, but the specific licensing and API details for this tier require contacting adityaryawork@gmail.com, and pricing and detailed terms are not provided in the materials. The project uses the MIT license, with a copyright year of 2026 and author Aditya Arya.
