A full-lifecycle SaaS backend built from scratch — combining traditional astrology engines with AI-powered personalization, real-time chat, and production-grade subscription billing.
Most astrology apps are static content. This platform is a dynamic, AI-augmented SaaS — delivering personalized predictions, real-time interactions, and intelligent content generation, all backed by a modular, scalable backend I designed and owned end-to-end.
- Transformer-based text summarization using BART — powers horoscope reports, blog summaries, and personalized content
- AI-assisted live chat with intelligent conversational workflows
- Domain-specific content enhancement for astrology interpretations
- Kundli (Birth Chart) generation with AI-powered interpretation
- Dasha predictions, Panchang calculations, daily Horoscope
- Numerology & Loshu Grid analysis
- Compatibility matching and astrological reports
- Subscription state machine — trial → paid → cancellation with automated transitions
- Recurring billing, invoice generation, and transaction tracking
- Idempotent payment processing with webhook-driven sync and failure recovery
- Premium feature access control via subscription entitlements
- Real-time live chat system with AI-assisted workflows
- Blog and content publishing with AI summarization
- Personalized user dashboards and account-level views
- Live sessions, webinars, and recorded content delivery
- Role-based access control (RBAC) with JWT authentication
- Payment-safe idempotent architecture
- Centralized logging, error monitoring, and audit trails
- Production-grade configuration and secret management
┌─────────────────────────────────────────────────────────────────┐
│ API LAYER (DRF) │
│ Authentication · Subscriptions · Astrology · Chat · Content │
└────────────┬──────────────────────────────────────┬────────────┘
│ │
┌────────▼────────┐ ┌────────▼────────┐
│ Core Services │ │ AI / NLP │
│ Kundli · Dasha │ │ BART · Chat │
│ Panchang · etc │ │ Summarization │
└────────┬────────┘ └────────┬────────┘
│ │
┌────────▼──────────────────────────────────────▼────────┐
│ Data & Infrastructure Layer │
│ PostgreSQL · Redis (cache + queues) · Background Jobs │
│ AWS (EC2, RDS, S3) · Docker · CI/CD │
└─────────────────────────────────────────────────────────┘
| Layer | Technology |
|---|---|
| Backend | Python · Django · Django REST Framework |
| AI / NLP | BART Transformer · Hugging Face · AI chat workflows |
| Database | PostgreSQL · MySQL |
| Caching & Queues | Redis |
| Cloud | AWS (EC2, RDS, S3) |
| DevOps | Docker · CI/CD pipelines |
| Auth | JWT · RBAC |
| Frontend (supporting) | HTML5 · Tailwind CSS · JavaScript |
astro/ # Main project config
├── authentication/ # JWT auth, RBAC, session management
├── apis/ # Unified RESTful API layer
├── kundli/ # Birth chart generation + AI interpretation
├── dasha/ # Dasha prediction engine
├── panchang/ # Panchang & calendar calculations
├── horoscope/ # Daily/weekly horoscope generation
├── compatibility/ # Compatibility matching & analysis
├── numberlogy/ # Numerology & Loshu Grid
├── payment/ # Payment processing & webhook handling
├── subscription/ # Subscription plans, billing, entitlements
├── invoice/ # Invoice generation & transaction records
├── chat/ # Real-time chat + AI-assisted workflows
├── blogs/ # Content publishing & AI summarization
├── dashboard/ # Personalized user dashboards
├── commands/ # Background jobs & scheduled tasks
├── core/ # Shared business logic & reusable utilities
├── admin_panel/ # System management & content moderation
├── utility/ # Helper functions & shared utilities
└── manage.py
Each module is loosely coupled and independently maintainable — designed for scale from day one.
# Clone the repository
git clone https://github.com/amarkumar55/ai-astrology-saas.git
cd ai-astrology-saas
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # macOS / Linux
venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Configure environment variables
cp .env.example .env
# Edit .env with your DB, Redis, AWS, and API credentials
# Run database migrations
python manage.py migrate
# Start the development server
python manage.py runserverDocker configuration, AWS infrastructure, and CI/CD pipelines are managed separately and excluded from this public repository for security and compliance reasons.
The application is production-deployed on AWS (EC2, RDS, S3) with containerized environments via Docker and automated deployment via CI/CD pipelines.
Country/state/city data sourced from the Countries States Cities Database, licensed under ODbL.
Amar Kumar — Senior Backend Engineer · IBM Certified AI Engineer
Specializing in distributed systems, AI-powered SaaS backends, and production-scale Python architecture.
This project is licensed under a restrictive license.
Commercial use, redistribution, or modification is not permitted without prior written authorization.
Built to demonstrate full product lifecycle ownership — from system design to production deployment.