astro-skill 1.1.1__tar.gz

astro_skill-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aditya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

astro_skill-1.1.1/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: astro-skill
+Version: 1.1.1
+Summary: Portable Vedic astrology engine, agent skill, and stdio MCP server (kundali, dasha, panchang, PDF reports)
+Author-email: Aditya Arya <adityarya24@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/adityarya24/astro-skill
+Project-URL: Documentation, https://github.com/adityarya24/astro-skill#readme
+Project-URL: Repository, https://github.com/adityarya24/astro-skill
+Project-URL: Issues, https://github.com/adityarya24/astro-skill/issues
+Project-URL: Changelog, https://github.com/adityarya24/astro-skill/blob/main/CHANGELOG.md
+Keywords: vedic,astrology,kundali,dasha,panchang,mcp,jyotish,swiss-ephemeris
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Religion
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.27.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: pyswisseph>=2.10.3.2
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: reportlab>=4.5.1
+Requires-Dist: tzdata>=2025.2
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pypdf>=6.12.2; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pyyaml>=6.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: setuptools>=77.0.0; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: license-file
+
+# Astro Skill
+
+[![CI](https://github.com/adityarya24/astro-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/adityarya24/astro-skill/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/astro-skill.svg)](https://pypi.org/project/astro-skill/)
+[![Python versions](https://img.shields.io/pypi/pyversions/astro-skill.svg)](https://pypi.org/project/astro-skill/)
+[![Astro Skill MCP server score](https://glama.ai/mcp/servers/adityarya24/astro-skill/badges/score.svg)](https://glama.ai/mcp/servers/adityarya24/astro-skill)
+
+Portable Vedic astrology engine, agent skill, and MCP server. Deterministic
+kundali, dasha, panchang, and yoga calculations with JSON and Hindi/English PDF
+reports — reusable by any agent or MCP-compatible client.
+
+<p align="center">
+  <img src="docs/images/sample-cover-hi.png" alt="Hindi PDF report cover" width="330">
+  <img src="docs/images/sample-lagna-chart.png" alt="North Indian lagna kundali chart" width="330">
+</p>
+<p align="center">
+  <img src="docs/images/sample-dasha-strip.png" alt="Vimshottari dasha timeline" width="670">
+</p>
+
+The repo is split so each layer can be reused on its own:
+
+- **`astro/`** — the portable skill: calculator scripts, reference data, bundled
+  Swiss Ephemeris + Devanagari font, and tests. Drop it into any agent or call
+  the scripts directly from Python.
+- **`services/astro_mcp/`** — a generic stdio MCP server exposing the same
+  calculations plus SQLite storage as 11 stable tools.
+- **`apps/`** — optional products built on top (e.g. a web panel scaffold).
+- **`docs/`** — architecture, roadmap, deployment, and operations docs.
+
+## Features
+
+- **Kundali** — lagna, rashi, nakshatra + pada, nine grahas (with retrograde),
+  whole-sign houses, and dosha flags (e.g. Mangalik with classical cancellation
+  rules).
+- **Planetary strength flags** — dignity, digbala, vargottama, combustion,
+  graha yuddha, functional benefic/malefic per lagna, and a composite
+  per-planet strength verdict.
+- **Yogas** — Gajakesari, Budhaditya, Pancha Mahapurusha, Raja, Neechabhanga,
+  Vipreet (Harsha/Sarala/Vimala), Kaal Sarp (full/partial), Parivartana
+  (maha/khala/dainya), and more — with cancellation checks where classical.
+- **Full 12-house bhava data** — house lords with placement + strength,
+  occupants, Parashari aspects received, and bhava karakas, surfaced in the
+  report JSON for downstream analysis.
+- **Gochar narrative** — month-by-month (quarterly for long windows) transit
+  sampling across the current antardasha window, with true per-date ephemeris
+  recomputation.
+- **Remedies data** — per-planet mantra/gemstone/fasting/daan/ritual reference
+  (Hindi + English) with prioritization by planetary weakness and running dasha.
+- **Optional LLM synthesis** — provider-pluggable prose layer (executive
+  summary, per-house analysis, dasha deep-dive, life-area forecasts, remedies)
+  generated strictly from the computed chart JSON; the pipeline degrades
+  gracefully to a factual report when no provider is configured.
+- **Navamsa (D9)** divisional chart in both JSON and the PDF report.
+- **Vimshottari dasha** — mahadasha + antardasha timeline with correct
+  birth-balance handling (the sub-period actually running at birth, not a fresh
+  lord/lord cycle).
+- **Daily Panchang** — tithi, vara, nakshatra, yoga, karana, sunrise/sunset —
+  anchored at sunrise (classical convention), with muhurta and yoga detection.
+- **Lahiri (Chitrapaksha) sidereal** positions, whole-sign houses.
+- **High precision** — bundled Swiss Ephemeris `.se1` data (SWIEPH) with an
+  automatic Moshier fallback; each output records the tier used in
+  `calculation.ephemeris`.
+- **Reports** — structured JSON, and PDF via a preferred HTML/Chromium renderer
+  (polished Devanagari) or a legacy in-process ReportLab fallback. Hindi/English,
+  with a bundled Noto Sans Devanagari font. The HTML renderer also supports a
+  `pandit_v1` premium template for pitch-ready operator reports.
+- **MCP server** — 11 tools over stdio, with SQLite-backed client/report storage,
+  input validation, and traversal-safe report filenames.
+
+## Install (PyPI)
+
+```bash
+pip install astro-skill
+
+# Optional: Chromium for the preferred HTML PDF renderer
+python -m playwright install chromium
+
+# Run the stdio MCP server
+astro-mcp
+# or: python -m services.astro_mcp
+```
+
+Requires Python 3.11+. For development from source, use the editable install below.
+
+## Quick start (from source)
+
+```bash
+git clone https://github.com/adityarya24/astro-skill.git
+cd astro-skill
+python -m venv .venv && . .venv/bin/activate    # Windows: .\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+pip install -e ".[dev]"
+
+# Optional: Chromium for the preferred HTML PDF renderer
+python -m playwright install chromium
+
+# Checks
+python -m pytest -q
+python -m ruff check astro services scripts
+```
+
+All tests pass; the HTML/Chromium PDF render test skips automatically until
+Chromium is installed. For OS-specific venv details and MCP client config
+examples, see [`docs/operations/install-smoke.md`](docs/operations/install-smoke.md).
+
+## LLM synthesis (optional)
+
+The premium report sections can carry LLM-written prose (bilingual hi/en),
+generated strictly from the computed chart JSON — prompts forbid inventing any
+placement, yoga, or date. Configure via environment variables:
+
+| Env var | Default | Meaning |
+| --- | --- | --- |
+| `ASTRO_LLM_PROVIDER` | `gemini` | `gemini`, `openai` (OpenAI-compatible), or `cli` |
+| `ASTRO_LLM_API_KEY` | *(empty)* | API key for the chosen provider |
+| `ASTRO_LLM_MODEL` | provider default | Model name |
+| `ASTRO_LLM_CLI_ARGS` | — | For `cli` provider: JSON argv with a `{prompt}` token |
+
+With no key configured, every section falls back to a compact factual digest —
+the pipeline never fails because a provider is down. Calls have timeouts and
+log provider failures to stderr.
+
+## MCP server
+
+`services/astro_mcp/` is an importable package and a runnable **stdio MCP
+server**. The same `TOOLS` registry powers the unit tests and the wire protocol
+— no duplicated logic, and no environment variables required.
+
+Tools (11): `parse_birth_details`, `save_client_profile`, `find_client_profile`,
+`list_client_reports`, `calculate_kundali`, `calculate_dasha`,
+`calculate_gochar`, `calculate_compatibility`, `calculate_panchang`,
+`generate_report_json`, `generate_pdf_report`.
+
+```bash
+python -m services.astro_mcp        # or `astro-mcp` after `pip install -e .`
+```
+
+Wire it into any MCP client (Claude Desktop, a Codex agent, or your own) by
+pointing the client's MCP config at that command with `cwd` set to the repo
+root. See [`services/astro_mcp/README.md`](services/astro_mcp/README.md) for the
+tool contract and config examples, and verify an install in one shot with:
+
+```bash
+python scripts/smoke_mcp_client.py
+```
+
+## Sample commands
+
+```bash
+# Kundali JSON
+python astro/scripts/kundali_calculator.py --dob 26/12/2019 --tob 09:15 \
+  --place Delhi --lat 28.6139 --lon 77.2090 --timezone Asia/Kolkata --json
+
+# Panchang JSON
+python astro/scripts/panchang_calculator.py --date 2026-05-21 \
+  --place Delhi --lat 28.6139 --lon 77.209 --timezone Asia/Kolkata --json
+
+# Hindi PDF (default HTML/Chromium renderer; add --renderer reportlab for the
+# no-browser fallback)
+python astro/scripts/pdf_report.py --kundali-json chart.json --dasha-json dasha.json \
+  --panchang-json panchang.json --output report.pdf --language hi
+
+# Pandit-style report
+python astro/scripts/pdf_report.py --kundali-json chart.json --dasha-json dasha.json \
+  --panchang-json panchang.json --output pandit-v1.pdf --language hi \
+  --template pandit_v1 --client-name "Client Name"
+```
+
+## Deployment
+
+Run it as a Docker MCP server or straight from Python. The default `Dockerfile`
+builds a slim image (Python, dependencies, Devanagari font, ephemeris data);
+`Dockerfile.full` adds Chromium for the HTML PDF renderer. See
+[`docs/deploy.md`](docs/deploy.md) for build, run, smoke-test, and MCP-client
+wiring instructions.
+
+## Documentation
+
+- [`docs/operations/install-smoke.md`](docs/operations/install-smoke.md) — fresh-clone install, MCP client config, smoke checklist.
+- [`docs/deploy.md`](docs/deploy.md) — Docker / MCP-client deployment.
+- [`docs/architecture/generic-astro-platform.md`](docs/architecture/generic-astro-platform.md) — layering and reuse model.
+- [`docs/architecture/astro-skill-roadmap.md`](docs/architecture/astro-skill-roadmap.md) — engine roadmap.
+- [`services/astro_mcp/README.md`](services/astro_mcp/README.md) — MCP server contract.
+- [`astro/SKILL.md`](astro/SKILL.md) — agent skill instructions.
+
+## Production notes
+
+- Positions use the bundled high-precision Swiss Ephemeris (SWIEPH) out of the
+  box, not the lower-precision Moshier fallback.
+- The default PDF path is HTML/Chromium for production Hindi rendering; ReportLab
+  stays as a no-browser fallback.
+- Generated runtime data lives under an ignored `data/` directory (or a
+  caller-provided output directory).
+- MCP tools validate their JSON schemas and keep generated filenames detached
+  from caller-controlled identifiers.
+- GitHub Actions runs install, Chromium setup, tests, ruff, and skill validation
+  on push and pull requests.
+
+## Safety boundaries
+
+These rules apply across every layer and downstream product:
+
+- Reports are calculation-backed drafts, intended for review by an astrologer or
+  operator before any final reading is shared.
+- Missing birth details must be requested rather than guessed.
+- Approximate or partial inputs must be marked clearly in any output.
+- Do not generate death, accident, medical, or unavoidable-harm certainty
+  predictions.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

astro_skill-1.1.1/README.md

@@ -0,0 +1,212 @@
+# Astro Skill
+
+[![CI](https://github.com/adityarya24/astro-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/adityarya24/astro-skill/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/astro-skill.svg)](https://pypi.org/project/astro-skill/)
+[![Python versions](https://img.shields.io/pypi/pyversions/astro-skill.svg)](https://pypi.org/project/astro-skill/)
+[![Astro Skill MCP server score](https://glama.ai/mcp/servers/adityarya24/astro-skill/badges/score.svg)](https://glama.ai/mcp/servers/adityarya24/astro-skill)
+
+Portable Vedic astrology engine, agent skill, and MCP server. Deterministic
+kundali, dasha, panchang, and yoga calculations with JSON and Hindi/English PDF
+reports — reusable by any agent or MCP-compatible client.
+
+<p align="center">
+  <img src="docs/images/sample-cover-hi.png" alt="Hindi PDF report cover" width="330">
+  <img src="docs/images/sample-lagna-chart.png" alt="North Indian lagna kundali chart" width="330">
+</p>
+<p align="center">
+  <img src="docs/images/sample-dasha-strip.png" alt="Vimshottari dasha timeline" width="670">
+</p>
+
+The repo is split so each layer can be reused on its own:
+
+- **`astro/`** — the portable skill: calculator scripts, reference data, bundled
+  Swiss Ephemeris + Devanagari font, and tests. Drop it into any agent or call
+  the scripts directly from Python.
+- **`services/astro_mcp/`** — a generic stdio MCP server exposing the same
+  calculations plus SQLite storage as 11 stable tools.
+- **`apps/`** — optional products built on top (e.g. a web panel scaffold).
+- **`docs/`** — architecture, roadmap, deployment, and operations docs.
+
+## Features
+
+- **Kundali** — lagna, rashi, nakshatra + pada, nine grahas (with retrograde),
+  whole-sign houses, and dosha flags (e.g. Mangalik with classical cancellation
+  rules).
+- **Planetary strength flags** — dignity, digbala, vargottama, combustion,
+  graha yuddha, functional benefic/malefic per lagna, and a composite
+  per-planet strength verdict.
+- **Yogas** — Gajakesari, Budhaditya, Pancha Mahapurusha, Raja, Neechabhanga,
+  Vipreet (Harsha/Sarala/Vimala), Kaal Sarp (full/partial), Parivartana
+  (maha/khala/dainya), and more — with cancellation checks where classical.
+- **Full 12-house bhava data** — house lords with placement + strength,
+  occupants, Parashari aspects received, and bhava karakas, surfaced in the
+  report JSON for downstream analysis.
+- **Gochar narrative** — month-by-month (quarterly for long windows) transit
+  sampling across the current antardasha window, with true per-date ephemeris
+  recomputation.
+- **Remedies data** — per-planet mantra/gemstone/fasting/daan/ritual reference
+  (Hindi + English) with prioritization by planetary weakness and running dasha.
+- **Optional LLM synthesis** — provider-pluggable prose layer (executive
+  summary, per-house analysis, dasha deep-dive, life-area forecasts, remedies)
+  generated strictly from the computed chart JSON; the pipeline degrades
+  gracefully to a factual report when no provider is configured.
+- **Navamsa (D9)** divisional chart in both JSON and the PDF report.
+- **Vimshottari dasha** — mahadasha + antardasha timeline with correct
+  birth-balance handling (the sub-period actually running at birth, not a fresh
+  lord/lord cycle).
+- **Daily Panchang** — tithi, vara, nakshatra, yoga, karana, sunrise/sunset —
+  anchored at sunrise (classical convention), with muhurta and yoga detection.
+- **Lahiri (Chitrapaksha) sidereal** positions, whole-sign houses.
+- **High precision** — bundled Swiss Ephemeris `.se1` data (SWIEPH) with an
+  automatic Moshier fallback; each output records the tier used in
+  `calculation.ephemeris`.
+- **Reports** — structured JSON, and PDF via a preferred HTML/Chromium renderer
+  (polished Devanagari) or a legacy in-process ReportLab fallback. Hindi/English,
+  with a bundled Noto Sans Devanagari font. The HTML renderer also supports a
+  `pandit_v1` premium template for pitch-ready operator reports.
+- **MCP server** — 11 tools over stdio, with SQLite-backed client/report storage,
+  input validation, and traversal-safe report filenames.
+
+## Install (PyPI)
+
+```bash
+pip install astro-skill
+
+# Optional: Chromium for the preferred HTML PDF renderer
+python -m playwright install chromium
+
+# Run the stdio MCP server
+astro-mcp
+# or: python -m services.astro_mcp
+```
+
+Requires Python 3.11+. For development from source, use the editable install below.
+
+## Quick start (from source)
+
+```bash
+git clone https://github.com/adityarya24/astro-skill.git
+cd astro-skill
+python -m venv .venv && . .venv/bin/activate    # Windows: .\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+pip install -e ".[dev]"
+
+# Optional: Chromium for the preferred HTML PDF renderer
+python -m playwright install chromium
+
+# Checks
+python -m pytest -q
+python -m ruff check astro services scripts
+```
+
+All tests pass; the HTML/Chromium PDF render test skips automatically until
+Chromium is installed. For OS-specific venv details and MCP client config
+examples, see [`docs/operations/install-smoke.md`](docs/operations/install-smoke.md).
+
+## LLM synthesis (optional)
+
+The premium report sections can carry LLM-written prose (bilingual hi/en),
+generated strictly from the computed chart JSON — prompts forbid inventing any
+placement, yoga, or date. Configure via environment variables:
+
+| Env var | Default | Meaning |
+| --- | --- | --- |
+| `ASTRO_LLM_PROVIDER` | `gemini` | `gemini`, `openai` (OpenAI-compatible), or `cli` |
+| `ASTRO_LLM_API_KEY` | *(empty)* | API key for the chosen provider |
+| `ASTRO_LLM_MODEL` | provider default | Model name |
+| `ASTRO_LLM_CLI_ARGS` | — | For `cli` provider: JSON argv with a `{prompt}` token |
+
+With no key configured, every section falls back to a compact factual digest —
+the pipeline never fails because a provider is down. Calls have timeouts and
+log provider failures to stderr.
+
+## MCP server
+
+`services/astro_mcp/` is an importable package and a runnable **stdio MCP
+server**. The same `TOOLS` registry powers the unit tests and the wire protocol
+— no duplicated logic, and no environment variables required.
+
+Tools (11): `parse_birth_details`, `save_client_profile`, `find_client_profile`,
+`list_client_reports`, `calculate_kundali`, `calculate_dasha`,
+`calculate_gochar`, `calculate_compatibility`, `calculate_panchang`,
+`generate_report_json`, `generate_pdf_report`.
+
+```bash
+python -m services.astro_mcp        # or `astro-mcp` after `pip install -e .`
+```
+
+Wire it into any MCP client (Claude Desktop, a Codex agent, or your own) by
+pointing the client's MCP config at that command with `cwd` set to the repo
+root. See [`services/astro_mcp/README.md`](services/astro_mcp/README.md) for the
+tool contract and config examples, and verify an install in one shot with:
+
+```bash
+python scripts/smoke_mcp_client.py
+```
+
+## Sample commands
+
+```bash
+# Kundali JSON
+python astro/scripts/kundali_calculator.py --dob 26/12/2019 --tob 09:15 \
+  --place Delhi --lat 28.6139 --lon 77.2090 --timezone Asia/Kolkata --json
+
+# Panchang JSON
+python astro/scripts/panchang_calculator.py --date 2026-05-21 \
+  --place Delhi --lat 28.6139 --lon 77.209 --timezone Asia/Kolkata --json
+
+# Hindi PDF (default HTML/Chromium renderer; add --renderer reportlab for the
+# no-browser fallback)
+python astro/scripts/pdf_report.py --kundali-json chart.json --dasha-json dasha.json \
+  --panchang-json panchang.json --output report.pdf --language hi
+
+# Pandit-style report
+python astro/scripts/pdf_report.py --kundali-json chart.json --dasha-json dasha.json \
+  --panchang-json panchang.json --output pandit-v1.pdf --language hi \
+  --template pandit_v1 --client-name "Client Name"
+```
+
+## Deployment
+
+Run it as a Docker MCP server or straight from Python. The default `Dockerfile`
+builds a slim image (Python, dependencies, Devanagari font, ephemeris data);
+`Dockerfile.full` adds Chromium for the HTML PDF renderer. See
+[`docs/deploy.md`](docs/deploy.md) for build, run, smoke-test, and MCP-client
+wiring instructions.
+
+## Documentation
+
+- [`docs/operations/install-smoke.md`](docs/operations/install-smoke.md) — fresh-clone install, MCP client config, smoke checklist.
+- [`docs/deploy.md`](docs/deploy.md) — Docker / MCP-client deployment.
+- [`docs/architecture/generic-astro-platform.md`](docs/architecture/generic-astro-platform.md) — layering and reuse model.
+- [`docs/architecture/astro-skill-roadmap.md`](docs/architecture/astro-skill-roadmap.md) — engine roadmap.
+- [`services/astro_mcp/README.md`](services/astro_mcp/README.md) — MCP server contract.
+- [`astro/SKILL.md`](astro/SKILL.md) — agent skill instructions.
+
+## Production notes
+
+- Positions use the bundled high-precision Swiss Ephemeris (SWIEPH) out of the
+  box, not the lower-precision Moshier fallback.
+- The default PDF path is HTML/Chromium for production Hindi rendering; ReportLab
+  stays as a no-browser fallback.
+- Generated runtime data lives under an ignored `data/` directory (or a
+  caller-provided output directory).
+- MCP tools validate their JSON schemas and keep generated filenames detached
+  from caller-controlled identifiers.
+- GitHub Actions runs install, Chromium setup, tests, ruff, and skill validation
+  on push and pull requests.
+
+## Safety boundaries
+
+These rules apply across every layer and downstream product:
+
+- Reports are calculation-backed drafts, intended for review by an astrologer or
+  operator before any final reading is shared.
+- Missing birth details must be requested rather than guessed.
+- Approximate or partial inputs must be marked clearly in any output.
+- Do not generate death, accident, medical, or unavoidable-harm certainty
+  predictions.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

astro_skill-1.1.1/astro/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: astro
+description: Vedic astrology calculation skill for kundali, dasha, panchang, gochar transits, guna milan, structured report JSON, and Hindi PDF reports. Use when an agent needs deterministic astrology from birth details, date, time, and location.
+---
+
+# Astro Skill
+
+Use this skill to calculate and explain Vedic astrology outputs. Keep responses practical, respectful, and grounded in computed data. Do not predict death, accidents, medical diagnoses, or unavoidable harm.
+
+## Defaults
+
+- Ayanamsa: Lahiri Chitrapaksha.
+- House system: whole sign.
+- Default language: Hinglish (`hin`), with Hindi (`hi`) and English (`en`) supported by callers.
+- Default location for non-birth daily work: Delhi, India.
+
+## Required Inputs
+
+- Kundali: date of birth, time of birth, place, latitude, longitude, timezone.
+- Dasha: kundali output from `kundali_calculator.py`.
+- Panchang: local date, place, latitude, longitude, timezone.
+- Basic report: kundali JSON, with optional dasha JSON and panchang JSON.
+- PDF report: kundali JSON plus optional dasha and panchang JSON; dasha is recommended for the timeline chart.
+- Gochar (transits): kundali JSON plus a local calendar date (and optional place for location-sensitive work).
+- Guna Milan: two complete kundali JSON files (both people need full birth details).
+- Muhurta and other advanced modules may require purpose plus date range when implemented.
+
+## Phase 1 Workflow
+
+1. Run `scripts/kundali_calculator.py` with birth details and `--json`.
+2. Inspect `lagna`, `rashi`, `nakshatra`, `nakshatra_pada`, `planets`, `houses`, and `dasha_seed`.
+3. Run `scripts/dasha_calculator.py --kundali-json <path> --json` when dasha timing is needed.
+4. Explain the output in the user's preferred language/tone. Mention calculations and practical meaning; avoid mystical filler.
+
+## Phase 2 Workflow
+
+1. Run `scripts/panchang_calculator.py` with local date, place, latitude, longitude, timezone, and `--json`.
+2. Inspect `vara`, `tithi`, `paksha`, `nakshatra`, `yoga`, `karana`, `sunrise`, and `sunset`.
+3. Use the Panchang output as calculation data for daily guidance or later muhurta work. Do not convert it into muhurta recommendations unless a muhurta module is available.
+4. If sunrise or sunset is `null`, check the `warnings` array and explain that the rest of the Panchang fields still came from computed solar/lunar positions.
+
+## Tier 2 Workflow (Gochar & Guna Milan)
+
+Use these after Phase 1 kundali JSON exists. Outputs are calculation-backed; keep interpretation conservative and avoid certainty claims.
+
+### Gochar (transit snapshot)
+
+1. Run `scripts/kundali_calculator.py` for the native chart and save `--json` output.
+2. Run `scripts/gochar_calculator.py --kundali-json <chart.json> --date YYYY-MM-DD --json`.
+3. Explain which grahas are transiting which rashis/houses relative to the natal lagna. Mention retrograde flags when present.
+4. Do not treat gochar as fate prediction; frame as timing context for operator review.
+
+### Guna Milan (Ashtakoot compatibility score)
+
+1. Build kundali JSON for person A and person B (full DOB, TOB, place, lat, lon, timezone).
+2. Run `scripts/guna_milan.py --kundali-a-json <a.json> --kundali-b-json <b.json> --json`.
+3. Present the scored breakdown (guna table, total, dosha flags) from JSON only.
+4. Compatibility scores are heuristic drafts, not relationship verdicts. An astrologer remains the final authority.
+
+## Phase 3 Workflow
+
+1. Generate or load kundali JSON. Optionally generate dasha JSON and daily panchang JSON.
+2. Run `scripts/report_generator.py --kundali-json <chart.json> --dasha-json <dasha.json> --panchang-json <panchang.json> --json`.
+3. Use the structured report as an astrologer/operator draft: birth chart facts, current dasha, daily Panchang, and safety notes.
+4. Keep interpretation clearly separated from calculation. The reviewing astrologer or operator remains the final authority.
+
+## Phase 4 Workflow
+
+1. Generate or load kundali JSON. Generate dasha JSON when the PDF should include a dasha timeline chart.
+2. Run `scripts/pdf_report.py --kundali-json <chart.json> --dasha-json <dasha.json> --panchang-json <panchang.json> --output output/pdf/<name>.pdf --renderer html`.
+   The default `--renderer html` uses Chromium via Playwright and is the
+   preferred path for Hindi/Devanagari polish. Use `--renderer reportlab` to
+   fall back to the legacy in-process renderer (lower-quality maatra
+   shaping, but no browser dependency).
+3. Install the browser once with `python -m playwright install chromium` if
+   the HTML renderer reports it is missing.
+4. Check the PDF text or rendered pages before sharing. The PDF includes a planet/house chart, planet table, dasha timeline, Panchang section, and safety notes when those inputs are present.
+5. Keep PDF content calculation-first. Treat it as a formatted working draft for astrologer/operator review.
+
+## Command Examples
+
+```bash
+python scripts/kundali_calculator.py --dob 26/12/2019 --tob 09:15 --place Delhi --lat 28.6139 --lon 77.2090 --timezone Asia/Kolkata --json
+python scripts/dasha_calculator.py --kundali-json chart.json --json
+python scripts/gochar_calculator.py --kundali-json chart.json --date 2026-07-01 --json
+python scripts/guna_milan.py --kundali-a-json bride.json --kundali-b-json groom.json --json
+python scripts/panchang_calculator.py --date 2026-05-21 --place Delhi --lat 28.6139 --lon 77.209 --timezone Asia/Kolkata --json
+python scripts/report_generator.py --kundali-json chart.json --dasha-json dasha.json --panchang-json panchang.json --json
+python scripts/pdf_report.py --kundali-json chart.json --dasha-json dasha.json --panchang-json panchang.json --output output/pdf/report.pdf
+```
+
+## Dependency Handling
+
+The calculator requires `pyswisseph` for Swiss Ephemeris. If it is missing, install the project dependencies or install `pyswisseph` directly. Do not silently approximate kundali positions without an ephemeris.
+
+PDF generation supports two renderers:
+
+- `html` (default, preferred) — uses `playwright` + a Chromium binary for
+  print-CSS-styled output with proper Devanagari shaping. Install the
+  browser once with `python -m playwright install chromium`. If Chromium is
+  missing the renderer raises a clear `RuntimeError` with the install
+  command.
+- `reportlab` (fallback) — uses `reportlab` in-process. No browser needed,
+  but Devanagari maatras are not perfectly shaped.
+
+PDF test extraction uses `pypdf` in the development environment.

astro_skill-1.1.1/astro/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Astro"
+  short_description: "Calculate Vedic kundali and Vimshottari dasha."
+  default_prompt: "Calculate a Vedic astrology chart from birth details."

astro_skill-1.1.1/astro/config/defaults.json

@@ -0,0 +1,12 @@
+{
+  "ayanamsa": "lahiri",
+  "house_system": "whole_sign",
+  "default_timezone": "Asia/Kolkata",
+  "default_location": "Delhi",
+  "default_lat": 28.6139,
+  "default_lon": 77.209,
+  "default_geoname_id": "1273294",
+  "language": "hin",
+  "report_format": "markdown",
+  "dasha_system": "vimshottari"
+}