Getting Started

Up and running in 5 minutes.

Vedākṣha ships as native Rust, a Python wheel via PyO3, and a WebAssembly package for browsers and edge runtimes. Pick your platform and follow the steps below.

1

Install

Add Vedākṣha to your project using the package manager for your platform.

RustCargo.toml

cargo add vedaksha

Pythonterminal

pip install vedaksha

WASMpackage.json

npm add vedaksha-wasm

2

Compute a Chart

Pass a Julian Day and coordinates. One function call returns a complete natal chart.

main.rs

use vedaksha::prelude::*;

let jd = calendar_to_jd(2024, 3, 20, 12.0);
let chart = compute_chart(
  jd, 28.6139, 77.2090,
  &ChartConfig::vedic()
);

for planet in &chart.planets {
  println!("{}: ° {}",
    planet.name, planet.longitude,
    planet.sign);
}

3

Read the Output

Every planet in chart.planets carries a full set of computed fields. No post-processing required.

.longitude

Ecliptic longitude in degrees (0–360). Sub-arcsecond precision from JPL DE440.

.sign

Zodiac sign as a typed enum — Sign::Aries, not integer 0.

.house

Whole-number house placement (1–12) in the selected house system.

.speed

Daily motion in degrees. Negative values indicate retrograde motion.

.retrograde

Boolean flag. True when daily speed is negative.

.nakshatra

One of 27 nakshatras with pada (quarter, 1–4) for Vedic charts.

4

Next Steps

Full Documentation

House systems, coordinate pipeline, Shadbala, ayanamshas, and every API surface.

Browse docs →

AI Integration

Connect Vedākṣha to Claude, GPT, or any MCP-compatible agent in minutes.

AI overview →

Integration Guides

Step-by-step guides for every workflow, from natal charts to transit searches.

View guides →