# AstroSpirit — AI Astrology Telegram Bot

> AstroSpirit is a multilingual AI-powered astrology Telegram bot providing free daily Tarot readings, horoscopes, natal chart analysis, and zodiac compatibility in 11 languages.

## About

AstroSpirit is a free astrology assistant built as a Telegram bot. It uses artificial intelligence to generate personalized astrological insights based on precise astronomical calculations (Swiss Ephemeris / JPL DE441). The bot serves users worldwide in 11 languages: English, Russian, Spanish, French, Portuguese, Arabic, Persian, Hindi, Turkish, Chinese, and Indonesian.

## Core Features

- **Daily Horoscopes**: AI-generated personalized horoscopes for all 12 zodiac signs (Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces) covering love, career, health, and finance
- **Tarot Readings**: AI-interpreted Tarot card spreads including single card, 9-card spread, Celtic Cross, and relationship readings with 78 Major and Minor Arcana cards
- **Natal Chart Analysis**: Full birth chart calculation with planetary positions, houses, and aspects using Swiss Ephemeris (JPL DE441 precision)
- **Zodiac Compatibility**: Detailed compatibility analysis between any two zodiac signs for love, friendship, and work
- **Card of the Day**: Free interactive Tarot card on the landing page with daily cosmic messages
- **Multilingual Support**: Full localization in 11 languages with automatic language detection and timezone-based geo-routing

## Website

- https://astrospirit.press

## Telegram Bot

- Bot: @astrogicbot (https://t.me/astrogicbot)

## Sister Project

- Astraelle: https://astraelle.space — 11 languages, extended features

## Technical Details

- Platform: Telegram Bot API (aiogram 3.x)
- AI Engine: OpenAI GPT-4 for interpretation and content generation
- Astronomy: Swiss Ephemeris with JPL DE441 ephemeris for planetary calculations
- Geocoding: Self-hosted Nominatim (OpenStreetMap) for birth location resolution
- Infrastructure: Ubuntu VPS, Docker, Nginx, PostgreSQL, Cloudflare CDN/WAF
- Languages: Python 3.11+

## Zodiac Signs Supported

Aries (♈), Taurus (♉), Gemini (♊), Cancer (♋), Leo (♌), Virgo (♍), Libra (♎), Scorpio (♏), Sagittarius (♐), Capricorn (♑), Aquarius (♒), Pisces (♓)

## Use Cases

1. Get a daily horoscope for any zodiac sign
2. Draw and interpret Tarot cards with AI-powered meanings
3. Calculate your natal (birth) chart with exact planetary positions
4. Check zodiac compatibility with a partner or friend
5. Explore cosmic insights in your native language

## FAQ

**Q: Is AstroSpirit free?**
A: Yes! Daily horoscope and 1 Tarot reading per day are completely free. Premium features with deeper analysis are available via Telegram Stars.

**Q: How accurate are the calculations?**
A: AstroSpirit uses Swiss Ephemeris with JPL DE441 data — the same precision used by professional astronomers.

**Q: What languages does AstroSpirit support?**
A: English, Русский (Russian), Español (Spanish), Français (French), Português (Portuguese), العربية (Arabic), فارسی (Persian), हिन्दी (Hindi), Türkçe (Turkish), 中文 (Chinese), Bahasa Indonesia (Indonesian).

**Q: How does the Tarot reading work?**
A: Cards are drawn randomly from a full 78-card deck and interpreted by AI with context-aware personal meanings.

## Contact

- Telegram: @astrogicbot
- Website: https://astrospirit.press

---

*Last updated: 2025-02-23*