Astro Skill 是一个生产级、确定性的吠陀占星引擎，可将出生信息与天体坐标转换为结构化的数学星盘、时间线和事实性报告。项目定位为开源吠陀占星引擎、智能体技能与 MCP 服务器，强调计算驱动而非生成式猜测。
用途方面，它面向需要高精度、可复现吠陀占星计算的开发者、占星师、咨询机构以及消费级应用。其核心目标是把占星计算从依赖外部 API 或大模型自由生成，转变为基于瑞士星历表的确定性数学计算，从而避免幻觉。
主要能力包括：使用捆绑的瑞士星历表数据（.se1 SWIEPH，通过 pyswisseph）和 Lahiri（Chitrapaksha）岁差进行高精度计算；支持 kundali、Vimshottari dasha、panchang、gochar 与 Sade Sati、ashtakavarga、guna milan、分盘（divisional charts）以及印地语 janma patrika PDF 等。报告生成通过进程内 ReportLab 完成，支持印地语与英语双语 Kundali 和 Panchang 图表，并捆绑 Noto Sans Devanagari 字体，不依赖无头浏览器或 Chrome。项目宣称 100% 离线、零 API 密钥、零速率限制，占星计算无需网络调用。
使用方式提供三种即插即用的接口：第一，Stdio MCP 服务器（astro-mcp），暴露 11 个稳定工具，适用于 Claude Desktop、Cursor、Codex、OpenClaw 以及任何 Model Context Protocol 客户端，并内置 SQLite 客户端档案管理和报告生成；第二，Python 库与 CLI，可直接在 Python 中导入，或运行独立的 CLI 计算脚本并输出 --json；第三，Agent Skill，提供可移植的 SKILL.md，用于装备自主编码智能体和编排器。安装方面，可从 PyPI 安装，要求 Python 3.11+。
适用场景包括：为 MCP 客户端提供占星计算工具；在 Python 项目中集成吠陀占星计算；通过 CLI 快速生成 JSON 结果；为自主智能体提供占星技能；生成双语 Kundali 与 Panchang PDF 报告。
限制与边界：项目明确要求报告是数学基线，应由占星师或操作员审核后再分享；不得猜测或合成出生时间或地点，输入缺失时应提示用户；严格禁止生成宿命论断言、死亡时间、医疗诊断或不可避免的伤害预测。此外，仓库包含的是开源核心确定性引擎，即数学计算、结构化 JSON schema 和事实性 ReportLab PDF；面向占星师、咨询机构和消费级应用的 Pro Report Tier 提供 Pandit 级 LLM 综合、高级印刷版式以及优先可操作补救建议，但该层级的具体授权与 API 细节需联系 adityaryawork@gmail.com，资料中未提供价格与详细条款。项目采用 MIT 许可证，版权年份为 2026，作者 Aditya Arya。
