Installation

Prerequisites

Ketu requires:

Python 3.10 or higher
pip (Python package manager)

Stable Installation from PyPI

The simplest way to install Ketu:

pip install ketu

Installation from Source

Clone the Repository

git clone https://github.com/alkimya/ketu.git
cd ketu

Development Mode Installation

pip install -e .

This method allows you to modify the source code and see changes immediately.

Development Installation with Extras

For contributors, install the [dev] extra to get all testing and documentation tools:

pip install -e ".[dev]"

This installs pytest, coverage, mypy, sphinx, and other development dependencies.

Installation in a Virtual Environment (Recommended)

With venv

# Create the environment
python -m venv venv

# Install Ketu
pip install ketu

Installation Verification

Command Line

# Launch the interactive interface
ketu

In Python

import ketu
print(ketu.__version__)
# Output: 1.4.0

Dependencies

Ketu uses the following libraries:

Library	Version	Description
numpy	≥1.20.0	Numerical computations and arrays

Ketu is a pure NumPy library at runtime. pyswisseph is used only for generating Chiron ephemeris coefficients (a build-time tool, not a runtime dependency).

Uninstallation

pip uninstall ketu

Next Steps

Once installed, see the Quick Start Guide to begin using Ketu.