🚀 Hackerator - AI-Powered Idea Generator

🎯 Project Overview

Hackerator is an innovative AI-driven tool designed to assist students in selecting real-world topics for competitions, hackathons, and projects. By leveraging LLAMA 3.2: 3B, which runs locally on your machine, Hackerator provides an interactive UI with:

• A predefined set of topics for easy selection.
• An option to input custom prompts for generating tailored ideas.
• User authentication with register and login functionality.
• A credit system to manage AI-generated requests.

Whether you're struggling with brainstorming or need inspiration, Hackerator is your go-to AI companion for ideation! 💡

---

👥 Contributors

• Hemanthkumar - Backend & AI Integration
• Iniyaa - Frontend Development
• Gowsi - UI/UX Design

---

🛠️ Tech Stack

Frontend (User Interface)

• Angular (Interactive UI & UX)
• TypeScript (Strongly typed, scalable codebase)

Backend (AI Model Integration & Database)

• Express.js (Server & API handling)
• TypeScript (Backend logic & API structuring)
• LLAMA 3.2: 3B (Locally running AI model)
• MongoDB with Mongoose (Database for user management and credit system)

Additional Tools & Libraries

• Node.js & npm (Dependency management)

---

⚡ Features

✅ AI-Powered Topic Generation - Get AI-suggested ideas for your next hackathon or project.
✅ Custom Prompt Input - Provide your own keywords or problem statements.
✅ Interactive UI - Select from predefined categories with a seamless experience.
✅ Runs Locally - No external API calls, ensuring privacy and fast responses.
✅ Real-Time Suggestions - Get topic ideas instantly.
✅ User Authentication - Register and log in to save and track generated ideas.
✅ Credit System - Manage AI-generated requests using a credit-based system.

---

🏃 Getting Started

⚠️ Warning: Before running the application, you must install the Ollama software and download LLAMA 3.2: 3B (or your preferred model). Without this, the AI model will not function.

1️⃣ Clone the Repository

 git clone https://github.com/Hemanthkumar2k04/Hackerator.git
 cd Hackerator

2️⃣ Install Dependencies

For the Server:

 cd server
 npm install

For the Frontend:

 cd ..
 npm install

3️⃣ Run the Project

Start the Backend

 cd server
 npm run dev

Start the Frontend

 cd ..
 ng serve

🔹 The frontend will be available at http://localhost:4200/
🔹 The backend API will be running on http://localhost:5000/

---

📸 Screenshots

1. Login Page UI:
Light theme: https://github.com/user-attachments/assets/6e1bc289-7a62-400a-869c-9bc03c78e04f
Dark theme: https://github.com/user-attachments/assets/dd45015e-210d-4284-b58c-433ae4eef309

2. Registration Page UI:
https://github.com/user-attachments/assets/3f485aac-a4fc-465c-9e69-ddf8fe9e9a2f

3. Selection Page UI:
https://github.com/user-attachments/assets/5d590d8b-7b03-4ce6-b3b1-073030e53968

4. Generated Result Page UI:
https://github.com/user-attachments/assets/91feb74c-f9a3-47aa-b213-4a7be3e7417e

🚀 Future Enhancements

🔹 Collaborative Brainstorming - Share ideas with a team.
🔹 Export Feature - Save AI-generated ideas as PDFs or markdown files.
🔹 Advanced Credit System - Implement customizable credit plans.

---

🤝 Contributing

Want to contribute? Feel free to fork the repo and submit pull requests!

 git checkout -b feature-branch
 git commit -m "Added new feature"
 git push origin feature-branch

---

📄 License

This project is open-source and available under the MIT License.

---

🌟 If you like this project, don't forget to ⭐ the repo!