ephem-cli 0.5.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

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

Installation

pip install ephem-cli

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

• HTTP database API
• YAML-based database interaction
• 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.