Hacktoberfest 2025 Project Finder & Code Assistant

Your all-in-one tool to find the perfect open-source project for Hacktoberfest and get coding help along the way! This app combines a powerful project finder with an AI-powered code assistant.

✨ Features

• 🔍 Advanced Project Finder:
  • Pulls real-time repository data from the GitHub API.
  • Filter by multiple programming languages.
  • Search with keywords to find projects in your niche (e.g., "AI", "gamedev", "react").
  • Choose a difficulty level (Beginner, Intermediate, Advanced) to match your experience.
• 🤖 AI Code Assistant:
  • Powered by the Gemini API for intelligent and helpful responses.
  • Ask coding questions, get explanations, and receive code snippets.
  • Supports markdown for beautifully formatted code blocks.
• Modern & Responsive: A clean interface that works perfectly on any device.
• Zero Setup: Runs entirely in the browser. No API keys or local server needed.

🚀 How to Use the App

The app has two main views: the Project Finder and the Code Assistant.

Project Finder

1. Select Languages: Click the language tags you're interested in.
2. Add Keywords (Optional): Enter keywords to narrow your search.
3. Choose Difficulty:
   • Beginner: Finds projects with good first issues, perfect for newcomers.
   • Intermediate: Looks for popular projects with a moderate number of stars.
   • Advanced: Searches for highly popular and established projects.
4. Find Projects: Click the button to see a list of matching repositories from GitHub.
5. Explore: Each project card shows a description, language, and a direct link to its GitHub page.

Code Assistant

1. Switch Views: Click the "Code Assistant" toggle at the top of the page.
2. Ask a Question: Type any coding-related question into the chat box at the bottom.
3. Get Answers: The AI assistant will provide a detailed response, including code examples where helpful.

🛠️ Running the App

This is a static web application and requires no build steps or local server.

1. Download or clone the project files.
2. Open the index.html file directly in your web browser (e.g., Chrome, Firefox, Safari).

That's it! The app will be fully functional.

---

Happy Hacking! 🎉