
Astrol AI is a personal project I developed to explore the integration between artificial intelligence and conversational services, creating a complete ecosystem for personalized horoscopes. The project combines a Python Telegram bot, a Next.js landing page, Stripe payment system, and an automated pipeline for generating astral content.
Discover your personalized horoscope on astrolai.xyz
Technical Overview
The project is structured as a multi-component ecosystem:
- Telegram Bot: Python with python-telegram-bot for conversation management
- AI Engine: Claude API for contextual astrological response generation
- Landing Page: Next.js with internationalization and dark/light theme
- Payment System: Stripe for Basic/Premium subscription management
- Content Pipeline: Automated system for visual asset creation

Bot and AI Architecture
The Telegram bot implements:
- Conversation Handler: Conversation state management with persistence
- User Management: Usage tracking, plan limits, conversation history
- AI Integration: Claude API with prompt engineering for astrological responses
- Payment Integration: Stripe webhooks for subscription status management
- Logging System: Complete performance monitoring and usage analytics

Content Generation Pipeline
I developed an automated system for visual content creation:
- Template System: Custom backgrounds for each zodiac sign
- Text Overlay: Text rendering system with custom fonts and shadows
- Social Assets: Automatic image generation for different formats
- Daily Generation: Cron jobs for daily content creation
- Image Processing: Python pipeline with PIL for image manipulation

Technology Stack
The project consists of three main components:
Telegram Bot (Python):
- python-telegram-bot for conversation management
- Anthropic Claude API for astrological response generation
- Supabase for user management and conversation history
- Docker deployment with centralized logging
Landing Page:
- Next.js 14 with App Router for optimal performance
- Tailwind CSS with custom dark/light theme
- Stripe integration for payment and subscription management
- Complete internationalization (IT/EN)
Content Generation:
- Automated pipeline for horoscope image creation
- Python scripts for social content generation
- Customizable template system for each zodiac sign