Ancient Calculations. AI‑Assisted Interpretation. A full‑stack experimental Vedic Astrology application that focuses on chart calculation and AI‑generated explanations.

This project is not built by an astrologer.

• All astrological logic, calculations, and code structure are fully written using Google Gemini (gemini‑3‑pro).
• My role is engineering, integration, and validation, not astrological authorship.
• The AI does not calculate astrology — it only interprets already‑calculated results.

This project should be viewed as:

An AI‑assisted Vedic astrology software experiment

• Chart Calculation Uses **Swiss Ephemeris ** with Lahiri Ayanamsa,

• North Indian Chart Rendering Custom React‑based SVG logic to display a North Indian (Diamond‑style) Kundli.

• AI‑Generated Explanations Google Gemini analyzes:

  • Planetary placements
  • Houses and signs
  • Vimshottari Dasha timeline and converts them into readable natural‑language insights.

• Vimshottari Dasha Programmatic calculation of the dasha cycle down to Antardasha level.

• Geo‑Location Handling City‑based location lookup with automatic latitude, longitude, and timezone resolution.

• Python
• FastAPI
• Swiss Ephemeris (PySwissEph)

• Next.js 14 (App Router)
• TypeScript
• Tailwind CSS

• Google Gemini (via AI Studio)

git clone https://github.com/Dhruvil-8/VedicJyotish.git
cd VedicJyotish

cd backend
python -m venv venv

# Windows
.\venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

pip install -r requirements.txt

Create a .env file inside /backend:

GEMINI_API_KEY=your_google_ai_studio_key
GEMINI_MODEL=gemini-3-pro-preview
FRONTEND_URL=http://localhost:3000
MAX_QUESTIONS=3

python main.py
# Server runs at http://127.0.0.1:8000

cd frontend
npm install
npm run dev
# App runs at http://localhost:3000

• Improve calculation coverage (more Vargas, Yogas)
• PDF report export
• User authentication
• Multi‑language support
• More interactive and educational UI

This software is for educational and experimental purposes.

Astrological interpretations are generated by AI and should not be treated as professional, medical, financial, or life advice.