ephem-cli 0.1.0

a minimal and configurable astrology CLI

ephem

ephem is a minimal, opinionated, and configurable horoscope CLI designed with electional astrology and premodern revivalism in mind. It aims to be a portable, terminal version of print ephemerides in widespread use among astrologers prior to personal computers and GUIs, providing a reliable offline alternative to web-based chart generators.

Table of Contents

• Features
• Usage
• Installation
• Roadmap
• Contributing
• License

Features

• ephem now shows the current chart for your location.
• ephem asc prints the ascendant for your location, for an efficient, scriptable clock.
• ephem cast DATE TIME TITLE casts a chart for a specific event, like a birth.
• --save-config saves default place and display settings to ephem.ini
• Accommodates incomplete information by defaulting to UTC noon or Null Island (0,0) for hypothetical charts.
• Default ANSI coloring following Hellenistic planetary sect along with sign-based element and modality themes.

Usage

Show chart of the moment for your location:

ephem now

Cast an event or birth chart:

ephem cast 1998-08-26 8:20 "Jeon Soyeon" --lat 37.49 --lng 127.0855

ephem cast 1993-08-16 13:05 "Debian Linux"

Installation

PyPI

pip install ephem

From source

Clone this repo:

git clone https://codeberg.org/sailorfe/ephem.git

Create a venv:

python -m venv venv
source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Install locally:

pip install .

Roadmap

• Save, list, and view chart data from a SQLite database
• Conversion from local time to UTC and vice versa
• Pseudo "wheel" text output option in the style of Astrolog
• Alternate ANSI color schemes by sign triplicity or quadruplicity
• Integrate shell scriptable clock from ascendant
• config.ini with configparser!
• Option to hide coordinates from printing.

Contributing

This is my self-taught Python bootcamp project, so very much a work in progress as I learn. I welcome early testers and feedback but plan to keep development mostly solo for now.

License

Per the original Swiss Ephemeris C library, this software is licensed under the AGPL.