Skip to content

Guru-CodesAI/GithubportfolioAI

Repository files navigation

Live demo VIDEO: https://drive.google.com/file/d/1HMVySlCtKBb7oE-cQcXvVLhw8Jf8jdWm/view?usp=drivesdk

🚀 GitFolio AI - GitHub Portfolio Analyzer

Transform your GitHub profile into actionable insights with the power of AI

Ever wondered how your GitHub portfolio stacks up? GitFolio AI is your personal portfolio analyst that dives deep into your repositories, analyzes your code, and gives you a comprehensive score with personalized recommendations to level up your developer profile.

✨ What Makes It Special?

  • Smart Analysis: Powered by Google's Gemini AI to understand your code quality, project diversity, and contribution patterns
  • Beautiful Visualizations: Interactive charts and gauges that make your stats come alive
  • Actionable Insights: Get specific recommendations on how to improve your portfolio
  • Lightning Fast: Built with React and Vite for a smooth, responsive experience
  • Modern UI: Sleek glassmorphism design with dark mode that's easy on the eyes

🎯 Features

  • 📊 Portfolio Score: Get an overall score based on multiple factors
  • 🔍 Deep Dive Analysis: Understand your strengths and areas for improvement
  • 📈 Visual Metrics: See your stats through beautiful, interactive charts
  • 💡 Smart Recommendations: AI-powered suggestions tailored to your profile
  • Real-time Processing: Instant analysis of your GitHub data

🛠️ Tech Stack

  • Frontend: React 19 + TypeScript
  • Styling: Tailwind CSS with custom glassmorphism effects
  • Charts: Recharts for data visualization
  • AI: Google Gemini API for intelligent analysis
  • Build Tool: Vite for blazing-fast development
  • Animations: Framer Motion for smooth interactions

🚀 Getting Started

Prerequisites

Make sure you have Node.js installed on your machine.

Installation

  1. Clone the repository

    git clone https://github.com/Guru-CodesAI/GithubportfolioAI.git
    cd GithubportfolioAI
  2. Install dependencies

    npm install
  3. Set up your API key

    Create a .env.local file in the root directory and add your Gemini API key:

    GEMINI_API_KEY=your_api_key_here
    

    Don't have a key? Get one for free at Google AI Studio

  4. Run the app

    npm run dev
  5. Open your browser

    Navigate to http://localhost:3000 and start analyzing!

📖 How to Use

  1. Enter any GitHub username in the search box
  2. Hit "Analyze Portfolio" and let the AI work its magic
  3. Explore your comprehensive analysis with scores, charts, and recommendations
  4. Use the insights to improve your GitHub presence

🎨 Screenshots

Coming soon - the app speaks for itself when you run it!

🤝 Contributing

Found a bug? Have a feature idea? Contributions are welcome!

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

📝 License

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

💬 Feedback

Have questions or suggestions? Feel free to open an issue or reach out!

🌟 Show Your Support

If you find this project helpful, give it a ⭐️ on GitHub!


Built with ❤️ by Guru-CodesAI

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published