ephem-cli 1.0.0

a minimal and configurable astrology CLI

Ephem

Ephem is a minimal, opinionated astrology CLI.

It provides offline, terminal-based horoscope calculations using the Swiss Ephemeris, serving as a portable alternative to web-based chart generators.

Features

• Swiss Ephemeris calculations
• Readable, terminal-friendly table output
• Configurable default location
• Multiple display modes and ANSI color schemes
• Handles incomplete data gracefully

Installation

You can install ephem-cli directly from PyPI.

With pipx

pipx installs Python command-line apps in their own isolated environments, so you don’t have to worry about dependencies messing with your system.

pipx install ephem-cli

With pip

If you don’t have pipx, you can install with pip:

pip install --user ephem-cli

Make sure your Python user bin directory (often ~/.local/bin) is on your $PATH.

From source

Clone the repo and install in editable mode:

git clone https://codeberg.org/sailorfe/ephem.git
cd ephem
pip install -e .

Usage

# Chart for the current moment
ephem now

# Chart for a specific date and time; location optional
ephem cast 1993-08-16 13:05 "Debian Linux"

Commands

Command	Description
now	Calculate the chart of the moment
cast	Calculate chart for an event or birth
asc	Print current local ascendant
data	Manage chart database
config	Update saved preferences

Roadmap

v1.0.0

• Write unit tests
• Save, list, and view chart data in an SQLite database
• Sidereal zodiac and custom ayanamsa support
• Convert local time input to UTC
• Alternate ANSI color schemese
• Integrate ascendant
• config.ini with configparser
• Option to hide coordinates in output

Future

• calendar view for current and specified months
• YAML-based database interaction
• fight with configparser and argparse over display settings
• SVG wheel and square charts with multiple house systems

Contributing

Ephem is in early development. Contributions are welcome, especially from developers with experience in astrology software.

Acknowledgments

Ephem draws inspiration from:

• Swiss Ephemeris and Astro.com
• Astrolog by Walter Pullen
• Planetdance by Jean Cremers
• The American Ephemeris by Neil F. Michelsen and Rique Pottenger
• Astrological Chart Calculations by Bruce Scofield

More information

• Changelog – Version history and updates.
• Devlogs — Real-time development notes
• Hackstrology — Biweekly astrology newsletter

License

Licensed under AGPL v3. See LICENSE file for details.