# Vedākṣha

> Vedākṣha (vedaksha, "vision from Vedas") is a clean-room astronomical ephemeris and Vedic astrology (Jyotish) computation engine by ArthIQ Labs LLC. One Rust codebase, four surfaces — Rust, Python, WebAssembly, and a Model Context Protocol (MCP) server — for computing natal charts (kundali / janam kundali), panchanga, dasha timelines, nakshatras, vargas, shadbala, ashtakavarga, gochara (transits), and muhurta windows. Accuracy is measured, not asserted: validated against 24,350 JPL Horizons DE441 reference positions with a 0.106″ mean residual (1.184″ max) over 1900–2025 on the sub-arcsecond DE440s tier.

Current engine version: 4.0.0 (released 2026-07-23). License: Business Source License 1.1 — free for non-commercial use, $500 one-time per organization for commercial use; each version converts to Apache 2.0 five years after its release.

## What it computes

- Natal charts (kundali) from julian_day + latitude + longitude only — the engine is PII-blind by construction (no name, birth-date-string, or user-id fields exist in its schemas)
- Panchanga (5 limbs: tithi, vara, nakshatra, yoga, karana)
- 5 dasha systems: Vimshottari, Ashtottari, Yogini, Chara, Narayana (BPHS Ch.46–47, Jaimini Sutras)
- 27 nakshatras with pada; 16 varga (divisional) charts D-1 through D-60
- 44 ayanamshas (Lahiri, Krishnamurti/KP, Fagan-Bradley, Raman, and more); 10 house systems (Placidus through Sripathi)
- Shadbala (with Ishta/Kashta phala), Bhinna + Sarva Ashtakavarga, graded drishti, combustion with per-planet orbs, chara karakas (7- and 8-scheme), gochara transit analysis with Vedha, muhurta window search, transit search
- Chart output as a property graph (ChartGraph: 9 node types, 12 edge types) emittable to Cypher, SurrealQL, or JSON-LD for graph-database queries over charts

## Accuracy (measured against JPL, reproducible from the repo)

- SPK tier (reads a JPL DE440s kernel): 0.106″ mean / 1.184″ max vs 15,350 JPL Horizons DE441 positions, 1900–2025
- Analytical tier (zero data files, VSOP87A + ELP/MPP02): Moon 0.17″ mean; all bodies 2.06″ mean, 24.22″ max (Venus), 1900–2025
- Test suite: 820 tests on every CI push; 873 in the scheduled full validation including the 24,350-row Horizons oracle comparison
- Every algorithm cites its primary source inline (Meeus, VSOP87A, ELP/MPP02, IAU 2006/2000B, BPHS in the Santhanam translation, Jaimini Sutras)

## Install (four surfaces)

- Rust: `cargo add vedaksha` — https://crates.io/crates/vedaksha, API docs at https://docs.rs/vedaksha
- Python: `pip install vedaksha` — https://pypi.org/project/vedaksha/. Runs the real Rust engine compiled to WebAssembly via wasmtime (not a reimplementation; results are bit-identical to native). One py3-none-any wheel, any OS/CPU wasmtime supports, Python ≥ 3.9, no Rust toolchain. Ships a typed library, a `vedaksha` CLI, a self-hostable MCP server (stdio + HTTP), and an optional FastAPI REST projection (`pip install "vedaksha[rest]"`). Both analytical and sub-arcsecond (DE440s) ephemeris tiers.
- WebAssembly / JavaScript: `npm i vedaksha-wasm` — https://www.npmjs.com/package/vedaksha-wasm. Browser and edge runtimes, zero data files.
- MCP server: `cargo install vedaksha-mcp` (stdio for Claude Desktop / Cursor / VS Code, or HTTP), or Docker: `ghcr.io/arthiqlabs/vedaksha-mcp` (linux/amd64 + linux/arm64). As of v4.0.0 the self-hosted HTTP mode requires bearer-token auth: set VEDAKSHA_MCP_TOKEN (the server refuses to start without it unless --insecure-no-auth is passed); /health and the informational GET remain open.

## MCP tools (15, schemas generated from Rust and drift-tested in CI)

compute_natal_chart, compute_panchanga, compute_dasha, compute_vargas, compute_bhavas, compute_shadbala, compute_ashtakavarga, compute_drishti, compute_combustion, compute_karakas, compute_transit, search_transits, compute_gochara, search_muhurta, emit_graph

- Canonical read-only introspection mirror (initialize / ping / tools/list): POST https://vedaksha.net/api/mcp — tools/call there returns a JSON-RPC -32001 error with self-host instructions, because the engine runs where you host it
- Hosted technology showcase: https://mcp.vedaksha.net/mcp — 4 agent-friendly demo tools, anonymous, IP-rate-limited (60/hr, 500/day); a separate managed surface, not the full 15-tool library

## Pages

- https://vedaksha.net/ — overview: six architecture decisions with receipts
- https://vedaksha.net/why — the same decisions in longer form
- https://vedaksha.net/docs — developer reference and install paths
- https://vedaksha.net/docs/mcp — live MCP tool catalog
- https://vedaksha.net/ontology — ChartGraph property-graph schema
- https://vedaksha.net/playground — run the engine in your browser (vedaksha-wasm, fully client-side)
- https://vedaksha.net/status — engine version, CI status, measured accuracy, distribution channels
- https://vedaksha.net/pricing — BSL 1.1 terms, $500 one-time commercial license
- https://vedaksha.net/legal/bsl — full license text

## Source

- https://github.com/arthiqlabs/vedaksha — the public engine workspace (Rust crates + Python binding in bindings/python)
- Reference deployment: https://kundalimcp.com — KundaliMCP, a fully-packaged managed Jyotish MCP built on Vedākṣha core by the same team

Contact: info@arthiq.net (ArthIQ Labs LLC)