🌌 AstroGo: The Future of Astrology, Powered by AI 🌌

A unique blend of ancient wisdom and modern AI technology, giving you insights like never before.

---

🌠 About AstroGo

AstroGo is your personal AI-powered astrology companion. With a seamless combination of React Native and Flask, it uses advanced AI and traditional astrological calculations to deliver detailed, personalized readings. Perfect for astrology enthusiasts and anyone curious about their cosmic journey.

---

✨ App Screenshots ✨

---

✨ Key Features

• AI Chatbot 🤖: Powered by GPT-4-turbo, it provides real-time answers to all your astrology questions.
• In-Depth Astrological Calculations 🔮: Delivers insights into planetary positions, Dashas, ascendant, and more.
• Location-Based Insights 📍: Personalized readings based on precise geolocation with OpenCage API.
• User-Friendly Interface 🎨: A beautifully crafted UI with React Native for a seamless experience.
• Optimized for Performance 🚀: Real-time astrological data processing through a Flask API backend.

---

🛠️ Tech Stack

Component	Technology
🌐 Frontend	React Native, Expo Router
🔧 Backend	Flask, Python, OpenAI API
🌍 Geolocation	OpenCage API
🔭 Astrology	swisseph, Custom Python Scripts

---

📂 Project Structure

AstroGo/
├── backend/                    
│   ├── app.py                  # Main Flask API code
│   ├── models/                 # Model storage
│   └── utils/                  # Helper scripts
├── frontend/                   
│   ├── App.js                  # Main React Native app entry
│   ├── components/             # UI components
│   └── screens/                # Screens and views
├── dataset/                    
│   └── astro_data.json         # Custom dataset of astrology knowledge
└── requirements.txt            # Python dependencies

---

📚 Libraries Used

Purpose	Library
Astrological Calculations	swisseph
Geolocation	OpenCageGeocode
Time Management	datetime, timedelta, pytz
Caching Optimization	functools (LRU Cache)
Backend Framework	Flask, Flask-CORS
Astrology Calculations Script	kundali_calculations.py
AI Model Interaction	openai
React Native UI Components	react-native, react-native-paper
Navigation	expo-router

---

🌟 Features and Workflow

AstroGo delivers an elevated astrology experience with the best of AI and classic Vedic calculations:

1. Data Processing:

   • Calculates planetary positions, Lagna, malefic/benefic influences, and Dasha cycles.
   • Determines planetary strength (strong, weak, neutral, or debilitated).

2. AI Chatbot:

   • Built with OpenAI’s fine-tuned GPT-4-turbo model, generating astrological insights and answering queries based on user-specific data.

3. Geolocation for Precision:

   • Integrates OpenCage API to refine predictions based on the user’s birth location, ensuring highly accurate readings.

---

🧑‍💻 Installation Guide

Prerequisites

• Node.js and npm for setting up the React Native frontend
• Python 3.x for the Flask backend
• OpenAI API Key and OpenCage API Key

Installation Steps

1. Clone the Repository

   git clone https://github.com/lkasym/AstroGo
   cd AstroGo

2. Backend Setup

   • Navigate to backend and install dependencies:

     cd backend
     pip install -r requirements.txt

   • Add your OpenCage API key and OpenAI API key to app.py.
   • Start the Flask API:

     python app.py

3. Frontend Setup

   • Go to the frontend directory:

     cd ../frontend
     npm install

   • Run the app:

     npm start

4. Connecting Backend and Frontend

   • Ensure the Flask API is running on http://localhost:5000. Update the API URL in the frontend if necessary.

---

📜 Data Sources

AstroGo’s knowledge base draws from respected sources in Vedic astrology, providing authenticity and depth in its predictions:

• Saptarishis Astrology Articles
• Brihat Parashara Hora Shastra (English)
• Phaladeepika (2nd Edition, 1950)

---

🤖 AI Model Training

AstroGo’s chatbot is powered by a fine-tuned GPT-4-turbo model, trained on a custom astrology dataset to provide accurate and insightful responses.

---

🚀 Future Enhancements

• User Profiles & History: Track and save previous readings for future reference.
• Social Media Integration: Enable users to share personalized readings.
• Expanded Astrological Techniques: Incorporate more complex interpretations for deeper insights.

---

📝 License

AstroGo is licensed under the MIT License. For more details, refer to the LICENSE file.

---

✨ Thank you for exploring AstroGo! ✨
We’d love to hear your feedback and suggestions! Contribute, open an issue, or give a ⭐️ on GitHub.