Skip to content

Installation

Edoardo BAROLO edited this page Jul 17, 2026 · 1 revision

Installation

Linux / Mac

git clone https://github.com/velteyn/OpenJyotish.git
cd OpenJyotish
./install.sh
./run.sh

The installer auto-detects Python 3.11+, creates a venv, installs dependencies, downloads ephemeris data, and initializes the database.

Windows

git clone https://github.com/velteyn/OpenJyotish.git
cd OpenJyotish
install.bat
run.bat

Release Zip (Windows — no Python)

Download openjyotish-v1.1.0-windows.zip from Releases. Extract, double-click OpenJyotish.bat. Everything included.

Requirements

  • Python 3.11+
  • Swiss Ephemeris data (auto-downloaded by install.sh)
  • 7 dependencies (auto-installed): PyQt6, pyswisseph, typer, rich, requests, prompt_toolkit, numpy

Ephemeris Data

The jhcore/ephe/ directory contains Swiss Ephemeris .se1 files (~94MB). These are NOT in the git repo. install.sh auto-downloads them from astro.com. On Windows, download manually from https://www.astro.com/ftp/swisseph/ephe/.

Verification

jhora --help           # Should list 27 commands
jhora chart "1973-03-13 13:55 +0100 45.41 11.88"  # Should display a chart

Clone this wiki locally