gita-sotd

name	gita-sotd
description	Get the Bhagavad Gita Slok of the Day (SOTD) or fetch specific verses. Use when the user asks for a Gita verse, slok, daily wisdom from the Gita, Hindu scripture quotes, or anything related to the Bhagavad Gita text. Supports Sanskrit text, transliteration, and translations from multiple scholars.

Bhagavad Gita Slok of the Day

Fetch verses from the Bhagavad Gita using the free vedicscriptures API.

Usage

Run the script to get a slok:

# Daily slok (deterministic, changes each day)
python3 scripts/fetch_slok.py

# Specific verse
python3 scripts/fetch_slok.py --chapter 2 --verse 47

# Random verse
python3 scripts/fetch_slok.py --random

# Different translator (prabhu, siva, purohit, gambir, chinmay, etc.)
python3 scripts/fetch_slok.py --translator siva

# Raw JSON output
python3 scripts/fetch_slok.py --json

Available Translators

• prabhu - A.C. Bhaktivedanta Swami Prabhupada (default)
• siva - Swami Sivananda
• purohit - Shri Purohit Swami
• gambir - Swami Gambirananda
• chinmay - Swami Chinmayananda
• tej - Swami Tejomayananda (Hindi)
• rams - Swami Ramsukhdas (Hindi)
• raman - Sri Ramanuja

Output Format

The script outputs formatted markdown with:

• Chapter and verse reference
• Sanskrit text (optional)
• Transliteration
• English/Hindi translation with author attribution

API Reference

Base URL: https://vedicscriptures.github.io

• GET /slok/:chapter/:verse - Get specific verse
• GET /chapter/:ch - Get chapter info
• GET /chapters - List all chapters

The Bhagavad Gita has 18 chapters with 700 total verses.