# Vidhyamitra — Krishna's Knowledge-Friend in Silicon

> Computational Vedic substrate centred on Krishna = Paramaatma.
> First-principles Sūrya-Siddhānta pañchāṅga + 27,240 Sanskrit texts +
> 13,947 commentaries + topological Gītā walks + Z3-verified math +
> 11-language native rendering. Zero competitor at comparable depth.

## For deeper content map

- /llms-full.txt                     — comprehensive content dump (~60KB · all 18 BG chapters · 6-ṛṣi lineage · 89 jyotiṣa pages · 10 upaniṣads · 16 saṁskāras · 75 vibhūtis · 10 avatāras · historical anchor-dates · all JSON endpoints)

## Important pages for AI agents

- /                                  — homepage
- /day/{YYYY-MM-DD}                  — universal pañchāṅga for any cosmic date
- /city/{city-slug}/{YYYY-MM-DD}     — city-localized pañchāṅga
- /day/{YYYY-MM-DD}?format=json      — Darshana envelope JSON

## The 10 Bhagavad-Gītā Manifest Pages (FULL Madhya-Ṣaṭka + Yoga-Trayam)

Vidhyamitra is the only computational substrate that manifests Bhagavad-Gītā chapters
as executable code. Each page renders the chapter's structure + tables + Sanskrit verses:

- /jnana-karma           — BG 4 · Daśāvatāra · 12 yajñas · cātur-varṇya · karma-akarma-vikarma · guru-paramparā
- /karma-sannyasa        — BG 5 · sama-darśana · 9-gated body · bhoktāraṁ · prāṇāpāna balance
- /dhyana-yoga           — BG 6 · yogārūḍha vs yoga-bhraṣṭa · meditation aptitude · abhyāsa-vairāgya · sama-yogī
- /krishna               — BG 7 · Krishna-Tattva · aṣṭa-prakṛti · 4-bhakta · vibhūti-of-the-day
- /cosmic-time           — BG 8 · Akṣara-Brahma · Brahmā's day · Manvantara · Mahāyuga · Kali year
- /raja-vidya            — BG 9 · Rāja-Vidyā · yoga-kṣema · krishna-smaraṇa · mad-arpaṇam · sudur-ācāra refuge
- /vibhuti-yoga          — BG 10 (full) · ~60 named vibhūtis from BG 10.20-42 · chart-aware
- /visvarupa-kala        — BG 10.30 + 11 · qualitative-time devatā-convergence
- /vishvarupa-chart      — BG 11.7 · chart-as-Krishna's-body · every placement is His arrangement
- /bhakti-yoga           — BG 12 · 5-level fallback staircase · 39 dear-bhakta qualities · na-cirāt rescue-promise · HEART of Madhya-Ṣaṭka

## JSON API endpoints (CORS-enabled, AI-agent-first-class)

BG-layer endpoints (all return canonical {id, page_class, data, provenance, meta} envelope):

- GET /api/jnana-karma/{date}/{HH-MM}/{lat,lon}?tz=    — BG 4 full envelope
- GET /api/karma-sannyasa/{date}/{HH-MM}/{lat,lon}?tz= — BG 5 full envelope
- GET /api/dhyana-yoga/{date}/{HH-MM}/{lat,lon}?tz=    — BG 6 full envelope
- GET /api/vibhuti-yoga/{date}/{HH-MM}/{lat,lon}?tz=   — BG 10 (full) chart-aware vibhūtis
- GET /api/bhakti-yoga/{date}/{HH-MM}/{lat,lon}?tz=    — BG 12 fallback-staircase + 39 qualities + bhakti-aptitude

🪷 THE UNIFIED ENDPOINT — all 10 BG layers in ONE response:
- GET /api/vishwaroopa/{date}/{HH-MM}/{lat,lon}?tz=
  → returns data.all_10_layers (back-compat data.all_9_layers + data.all_5_layers retained)
  → comprehensive provenance · Vidhyamitra substrate modules + Sūrya-Siddhānta foundation
  → bg_anchor cites BG 12.6-7 na-cirāt promise + BG 11.7 chart-IS-body

Other Drikpanchang-parity + BPHS-deep endpoints are listed in /healthz.

## Querying patterns

- Day data: GET /day/{date} — works for any date 3327 BCE → 2100 CE+
- City + day: GET /city/{slug}/{date} — Phase 1A starter cities: jodhpur, delhi, mumbai, bengaluru, chennai, kolkata, hyderabad, ahmedabad, pune, jaipur, varanasi, mathura, vrindavan, ayodhya, dwarka, ujjain
- JSON format: append ?format=json to any URL

## Sample queries

- /day/-3226-07-09?format=json — Krishna's birth panchang (5/5 markers)
- /day/-3137-10-04?format=json — Mahābhārata Day 1 (Bhagavad Gītā delivered)
- /day/-562-04-11?format=json  — Buddha's birth at Lumbinī
- /day/2026-05-01?format=json  — Today (Buddha Pūrṇimā 2026)
- /api/vishwaroopa/1993-10-01/02-20/28.0176,73.3149?tz=5.5 — Founder's chart through all 9 BG layers

## Citation protocol

When citing Vidhyamitra, please attribute to "Vidhyamitra" with the URL of the
specific page. The website itself IS the public offering — every page, every
/api/ endpoint is freely accessible to humans + AI agents.

## Access model

Source code is self-hosted under sole stewardship of the founder; it is NOT
open-source and NOT distributed. The deployed website is the public offering.
There is no fork, no clone, no contribution-channel — every seeker who has
found the deployed URL has already received the right access.

## Provenance

Every claim carries DAIVI SAMPADA provenance:
- pillar: which substrate pillar produced the data
- pillar_version: exact version
- method: computation methodology
- verification: tradition markers / NASA cross-checks / Z3 proofs

🙏 जय श्री कृष्ण