git404hub

what is openjyotish fr?

velteyn/openjyotish — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 3/5LicenseSetup · easy

tl;dr

A free, open source Vedic astrology toolkit with CLI, GUI, and terminal interfaces, plus optional AI chart readings powered by a locally run language model.

vibe map

mindmap
  root((repo))
    What it does
      Computes Vedic astrology charts
      Offers CLI GUI and TUI
      Local AI chart readings
    Tech stack
      Python
      PyQt6
      SQLite
      Ollama
    Use cases
      Generate a birth chart
      Check matchmaking compatibility
      Learn Vedic astrology concepts
    Audience
      Astrology enthusiasts
      Astrology software developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate a full Vedic astrology chart from a birth date, time, and location.

VIBE 2

Get an AI powered chart reading using a local language model like Ollama.

VIBE 3

Check astrological compatibility between two people using traditional matchmaking calculations.

what's the stack?

PythonPyQt6SQLiteOllama

how it stacks up fr

velteyn/openjyotish0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Windows users can download a ready made build, others need Python 3.11+ and an install script.

Free to use and modify, but any modified version, including one run as a network service, must also be released as open source.

in plain english

OpenJyotish is a free and open source toolkit for Vedic astrology, the traditional Indian system for interpreting birth charts. It offers three separate ways to use it: a command line interface with dozens of commands, a desktop graphical application built with PyQt6, and a text based terminal interface for those who prefer working without a mouse. All three read the same underlying calculation engine, so a chart worked out in one interface matches the others. Feed it a birth date, time, and location, and it can produce a full astrological chart along with many kinds of traditional Vedic calculations: planetary strengths, dozens of divisional charts, several different dasa systems that describe planetary time periods, hundreds of recognized planetary combinations called yogas, matchmaking compatibility scores between two people's charts, and tools for choosing auspicious timing for events. A single command can also dump every calculation as one large JSON file, meant to be easy for other programs or AI agents to read and process. The project also includes AI powered chart readings, but notably these run through a locally installed language model such as Ollama, rather than sending anyone's birth data to an outside service. There is also a teaching mode meant to help someone learn how to interpret Vedic astrology concepts, backed by a search tool over a collection of Vedic astrology textbooks bundled with the project. Installing it on Windows can be done with a ready made download that needs no separate Python installation. On Linux, Mac, or Windows with Python already installed, a short install script sets everything up, including downloading the small ephemeris files needed for planetary position calculations. The underlying calculation code traces back to an existing open source Vedic astrology library, and the software itself is released under the GNU General Public License version 3, meaning changes to the code must stay open, including when the software is run as a network service.

prompts (copy fr)

prompt 1
Help me install OpenJyotish from source on Linux and generate my first birth chart.
prompt 2
Explain how to use the jhora analyze JSON output to build my own astrology app.
prompt 3
Walk me through setting up Ollama so I can use OpenJyotish's AI chart reading feature.
prompt 4
Help me understand the dasa timeline output from OpenJyotish for my birth data.

Frequently asked questions

what is openjyotish fr?

A free, open source Vedic astrology toolkit with CLI, GUI, and terminal interfaces, plus optional AI chart readings powered by a locally run language model.

What language is openjyotish written in?

Mainly Python. The stack also includes Python, PyQt6, SQLite.

What license does openjyotish use?

Free to use and modify, but any modified version, including one run as a network service, must also be released as open source.

How hard is openjyotish to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is openjyotish for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.