🔭 AstroBot — Deep Space AI Agent

An intelligent astronomy AI agent that answers deep space questions with structured scientific responses, real NASA images, and trending research — completely free.

🚀 Live Demo · 📖 Documentation · 🐛 Report Bug · ✨ Request Feature

---

📌 Table of Contents

• About the Project
• Features
• Tech Stack
• Getting Started
• Project Structure
• How It Works
• Roadmap
• Author

---

🌌 About the Project

AstroBot is a full-stack AI agent web application built for astronomy enthusiasts, students, and researchers. Ask any question about the universe — from black holes to the Big Bang — and AstroBot responds with structured scientific answers, real NASA space imagery, and the latest research trends.

This project was built as Day 1 of a 120-day AI/ML engineering transformation — starting from zero and building toward production-grade AI systems.

"The cosmos is within us. We are made of star-stuff." — Carl Sagan

---

✨ Features

Feature	Description
🤖 AI Agent	Powered by Groq + LLaMA 3.3 70B — structured responses with derivations
🖼️ NASA Images	Real space photos fetched live from NASA Image Library
🌠 APOD	NASA Astronomy Picture of the Day in sidebar
📰 Trending Research	Latest 2023-2025 astronomy discoveries and missions
💬 Chat Memory	Full conversation history within each session
🆓 100% Free	No paid APIs required — Groq free tier + NASA free APIs
📱 Responsive	Works on desktop and mobile browsers

---

🛠️ Tech Stack

Backend

• Python 3.10+
• Flask 3.0
• Groq SDK (LLaMA 3.3 70B Versatile)

Frontend

• HTML5 / CSS3 / Vanilla JavaScript
• Marked.js (Markdown rendering)
• Custom space-themed UI

APIs (All Free)

• Groq API — AI responses via LLaMA 3.3 70B
• NASA Image and Video Library — Space images
• NASA APOD API — Picture of the Day

---

🚀 Getting Started

Prerequisites

• Python 3.10 or higher
• pip (Python package manager)
• A free Groq API key from console.groq.com

Step 1 — Clone the Repository

git clone https://github.com/tanmayakumar9070-ctrl/astrobot.git
cd astrobot

Step 2 — Get Your Free Groq API Key

1. Go to console.groq.com
2. Sign in / Sign up
3. Click API Keys → Create API Key
4. Copy the key

Step 3 — Add Your API Key

Create a file called config.py in the project folder:

GROQ_API_KEY = "paste_your_groq_key_here"

⚠️ config.py is in .gitignore — it will never be pushed to GitHub.

Step 4 — Install Dependencies

pip install -r requirements.txt

Step 5 — Run the Application

python Astrobot.py

Step 6 — Open in Browser

http://localhost:5000

🎉 AstroBot is live!

---

📁 Project Structure

astrobot/
│
├── Astrobot.py             # Flask backend — API routes, AI agent logic
├── requirements.txt        # Python dependencies
├── config.py               # 🔒 Your API key (NOT pushed to GitHub)
├── .gitignore              # Protects secrets from being committed
├── README.md               # You are here
│
└── templates/
    └── index.html          # Frontend — UI, chat interface, styling

---

⚙️ How It Works

User Question
      │
      ▼
Flask Backend (Astrobot.py)
      │
      ├──► Groq API (LLaMA 3.3 70B)
      │         │
      │         ▼
      │    Structured Response
      │    (Answer + Derivation +
      │     Implications + Insights)
      │
      └──► NASA Image Library API
                │
                ▼
           Relevant Space Images
                │
                ▼
         Combined Response
         sent to Frontend

Response Structure

Every AstroBot answer follows this format:

🔭 CORE ANSWER         — Scientific answer with real data
📐 MATHEMATICAL DERIVATION — Physics, equations, step by step
🌌 LATEST DISCOVERIES  — JWST, EHT, LIGO, Gaia findings 2023-2025
🧠 DEEP IMPLICATIONS   — Philosophy, humanity, unsolved paradoxes
💡 KEY INSIGHTS        — 5 surprising facts
🔗 EXPLORE FURTHER     — Papers and missions to investigate

---

🗺️ Roadmap

• Groq + LLaMA 3.3 AI agent
• NASA image integration
• Structured scientific responses
• APOD sidebar
• Conversation memory
• AstroBot v2 — RAG system with astronomy knowledge base
• Web search integration for real-time discoveries
• Agentic reasoning — multi-step space research
• Voice input support
• Mobile app (Android APK)

---

📊 Project Status

Day 1 of 120 — Foundation Phase
Status: Active Development
Next: Add RAG pipeline (Day 65-80)

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License.

---

👨‍💻 Author

Tanmaya Kumar Sahoo

Built as part of a 120-day AI/ML Engineering transformation — from zero to production-grade AI systems.

---

⭐ Star this repo if you found it useful!

Made with ❤️ and curiosity about the cosmos