Zodiacly ♈︎

Zodiacly is a lightweight Ruby gem for calculating zodiac signs and basic astronomical ephemeris data.

It provides:

• ♈︎ Zodiac sign calculation (with correct boundary handling)
• ☀️ Major celestial body positions
• 🔁 Retrograde detection (based on negative speed)
• 🧮 Simple CLI interface

Add to your Gemfile:

bundle add zodiacly

Or install directly:

gem install zodiacly

zodiacly ephemeris --bodies all

Options:

• --time UTC time (ISO8601 or now)
• --bodies Comma-separated list (sun,moon,mars) or all
• --version Show gem version
• --help Show help

Example:

zodiacly ephemeris --time 2026-02-07T00:00:00Z --bodies sun,moon

require "zodiacly"

# Example zodiac usage
Zodiacly::Zodiac.sign_for(Date.new(1990, 3, 21))

# Example ephemeris usage
Zodiacly::Ephemeris.calculate(time: Time.now.utc, bodies: :all)

Run tests:

bundle exec rspec

Build gem:

gem build zodiacly.gemspec

Release:

bundle exec rake release

MIT License.