gita / bhagavad-gita-api

Bhagavad Gita API is an open-source API that lets anyone use the text from Srimad Bhagavad Gita in their own web or mobile application(s).

🕉️ The Bhagavad Gita

The Bhagavad Gita in JSON

🙏 What is the Bhagavad Gita

• The Bhagavad Gita is one of the most prominent Hindu texts, forming a part of the Indian epic known as Mahabharata.
• Originally written in Sanskrit, the Bhagavad Gita is believed to have been composed between the 5th and 2nd century BCE.
• It is a guidebook to lead an enjoyable and blissful life. In other words, it is a user’s manual to lead a meaningful human life
• Lord Krishna imparted this knowledge to Arjuna in the battlefield of Kurukshetra, when the latter was in a distressful condition
• Upon receiving this knowledge returned to his happy and stable position
• All of us undergo difficult situations in life and often become overwhelmed by those situations not knowing where to find a solution
• The Bhagavad-Gita guides us out of such delusions and reestablishes us in our original position of eternity, knowledge and bliss
• If we follow the instructions as given by Lord Krishna, then we can attain the same blissful state as Arjuna did

🌸 How relevant is it in modern times

• The Bhagavad-gita is manual given by the Supreme Lord Krishna which guides us in making the best use of this human life and to deriving real happiness from it.
• In the modern times when people are more confused and misdirected, the Gita become all the more relevant for the individual as well as the society at large in bringing back the stability and happiness in life.

What is "The Bhagavad Gita"

The Gita is a dialogue between the warrior-prince Arjuna and the god Krishna who is serving as his charioteer at the Battle of Kurukshetra fought between Arjuna's family and allies (the Pandavas) and those of the prince Duryodhana and his family (the Kauravas) and their allies.

🚀 About Us

Bhagavad Gita is a practical guide to one's life that guides you to re-organise your life, achieve inner peace and approach the Supreme Lord (the Ultimate Reality). BhagavadGita.io is a modern Bhagavad Gita app with a simple, beautiful and easy to use interface, helping you focus on reading. It is an app built for Bhagavad Gita readers, by Bhagavad Gita readers.

Our Sites

https://vedvyas.org/

https://bhagavadgita.io/

https://radhakrishna.net/

https://hanumanchalisa.net/

Support

Reach out to us here https://bhagavadgita.io/contact/

bhagavad-gita-api's Issues

define a makefile target to build, tag with proper version info,and publish to DockerHub, Running `make docker` would do all the job.

think about using https://github.com/tiangolo/pydantic-sqlalchemy

we are manually creating the pydantic schemas. but the can be auto-generated from the sqlalchemy model

Add Sanskrit Recitations

Adding Sanskrit recitations from a reliable source to backend, making the field for that and deciding a cdn service for audio files,
as of now we can add the audio files along with JSON stored in https://github.com/gita/gita repo and it would work

Too slow scripts to add references

The scripts to add references is very unoptimised and slow because in each iteration it opens a new query for finding the ID of related tuple,
a much faster way is to have a Get All query once and then make a dict out of it and using in memory data to find IDs instead of making new query to server on each pass,

This need to be optimised for future users and contributors
Thanks
Hare Krishna

Create a cron job that selects a random verse every day

Create a cron job that selects a random verse every day at 12 am IST and stores its ID in a new table called verse_of_the_day.

Create an index page with a readme, API registration form and links to docs & repo

Currently, the / route returns 404.

Instead, we should create an index page with a readme, API registration form, and links to docs & repo.

For simplicity, let's just use Jinja2 along with Bootstrap instead of creating a SPA using react/vue.

the `/v2` route returns 404. it should return something like `{"Status": "up"}`

add badges for codecoverage|code quality|tests| version on readme

add some basic tests

Create a callback function for "Verse of the Day"

Create a callback function that queries the vese_of_the_day table at let's say 6 am IST every day and notifies all the subscribed applications of the latest verse of the day.

We could later use this for our own bots. So, when the API notifies our bots of the latest "Verse of the Day", our bots will parse and post it to the relevant social media channel.

Reference guide: https://fastapi.tiangolo.com/advanced/openapi-callbacks/

create ci `test.yml` to run tests on Ubuntu with python 3.8 and 3.9

create the wiki pages with guide to deploy to heroku, digital ocean, deta

[BUG] Missing line at Bhagavad Gita Shloka 1.20

🙁 Actual behavior

In this issue, it seems that the third line is missing in the Sanskrit version of the shloka. But it is completed in Romanized text.

Missing line

Complete shloka from holy-bhagavad-gita.org

🙂 Expected behavior

It should include the third line in the Sanskrit version of Shloka.

🔢 Steps to Reproduce the Problem

1. Go https://bhagavadgita.io/
2. Navigate to chapter 1 verse 20.
3. You can see the third line is missing in the Sanskrit version of the Verse.

Add Redis to docker-compose files

We need to add Redis to the docker-compose files so that celery can make use of them for verse of the day feature.

Documentation fix

What would you like to share?

There are quite a few grammatical errors and typos in the README file which should be corrected at the earliest. Ex: Gita should be preceded by the article 'the' i.e. 'The Gita' which sounds complete and correct.

I would be glad to fix these errors, if I am assigned to this issue.

Misc Todo

Once PR #3 is merged, I will start working on these

• #14
• #15
• #16
• reference once and update json data (the scripts that create references are too slow (why ?)) related to #11
• #6
• #7
• #17
• #18
• #19
• #20
• #21

Add Transliteration and Word meanings to GitaVerse

Data from previous version should be collected and cleaned and the GitaVerse model needs to hold 2 more attributes
the word meanings and Transliterations

create ci `publish.yml` to auto publish to pypi and dockerhub

add a contributors section that auto displays the images and names of all the contributors

fix threading errors related to database, test and make this work smoothly with Sqlite, Postgres, and MySQL

Set up a CI/CD pipeline on Github actions that deploys the API to DO/AWS

Code quality workflow failed in gh actions due to absense of flake8 in environment

Logs https://github.com/gita/bhagavad-gita-api/runs/2961739738#step:5:109

bhagavad-gita-api/.pre-commit-config.yaml

Lines 37 to 39 in a9ea31a

	- repo: local
	hooks:
	- id: flake8

pre-commit is using flake8 from local environment

[BUG] Instagram Cron Job is failing

🙁 Actual behavior

So our instagram accont was taken down because of voilation of their policies, using a 3rd party library to post images and stuff
so this made our social media cron job to get deactivated,

🙂 Expected behavior

We need to disable instagram post request and then reactivate the cron job that we are hosting on cron-jobs.org

we need to comment this line

bhagavad-gita-api/bhagavad_gita_api/api/api_v2/endpoints/social.py

Line 45 in 4f9ec88

instagram_response = bot.post_on_instagram()

and modify the below if statement to remove instagram condition

if twitter_response == 200 :
                return Response(
                    status_code=201,
                    content="Verse of the day has been posted on Instagram and twitter",
                )

🔢 Steps to Reproduce the Problem

No response

Prepare Audio recitations (Sanskrit) by scraping websites

Scrape and collect the media for all the 700 verses in separate audio files, with an easy naming convention,

Feat: Add Issue and PR template

Error while running with sqlite

we need to add this arguement automatically when using sqlite

connect_args={"check_same_thread": False}

Improvements to PreCommit

Can we add Mypy Precommit for static type checking ,
pydocstyle for numpy style documentation