An open API service indexing awesome lists of open source software.

https://github.com/shreyashpatel5506/githubanalyzer

AI-powered GitHub profile & repository analyzer with tech stack insights and project health scoring.
https://github.com/shreyashpatel5506/githubanalyzer

analytics gitprofile nextjs open-source openai openai-api profile react

Last synced: 3 months ago
JSON representation

AI-powered GitHub profile & repository analyzer with tech stack insights and project health scoring.

Awesome Lists containing this project

README

          

# githubanalyzer

Automated GitHub profile and repository analysis for developers, recruiters, and open-source contributors.

---

## Overview

githubanalyzer analyzes GitHub profiles and repositories to extract technology stacks, contribution patterns, and repository insights. Built for developers who need to quickly evaluate codebases and profiles without manual review.

**Key capabilities:**
- Repository-level technology stack detection
- Profile contribution analysis and activity summaries
- Commit pattern insights
- Clean, API-driven architecture

---

## Who It's For

- **Recruiters** evaluating candidate GitHub profiles during technical hiring
- **Developers** assessing repositories before contributing or integrating
- **Open-source contributors** exploring unfamiliar projects
- **Engineering teams** conducting codebase reviews and technology audits

---

## Features

- **Profile Analysis** — Comprehensive GitHub profile insights including contribution activity, repository distribution, and technology preferences
- **Repository Analysis** — Deep dive into repository structure, dependencies, and commit patterns
- **Tech Stack Detection** — Automated identification of languages, frameworks, and tools used across repositories
- **API Architecture** — Scalable backend with RESTful endpoints for programmatic access
- **Modern UI** — Responsive interface built with React and Tailwind CSS

---

## Tech Stack

#### Frontend
- React
- Next.js (App Router)
- Tailwind CSS

#### Backend
- Node.js
- Next.js API Routes

#### APIs
- GitHub REST API

#### Deployment
- Vercel

---

## Getting Started

### Prerequisites

- Node.js 18+ and npm
- GitHub Personal Access Token (optional, recommended for higher rate limits)

### Installation

1. Clone the repository

```bash
git clone https://github.com/your-username/gitprofileAi.git
cd gitprofileAi
```

2. Install dependencies

```bash
npm install
```

3. Configure environment variables

Create a `.env.local` file in the root directory:

```env
GITHUB_TOKEN=your_github_token_here
```

> **Note:** A GitHub token is optional but recommended to avoid API rate limits. Never commit your token to version control.

4. Run the development server

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000) in your browser.

---

## Contributing

We welcome contributions. Please follow these steps:

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/your-feature-name`)
3. Make your changes
4. Commit with clear messages (`git commit -m 'Add feature'`)
5. Push to your fork (`git push origin feature/your-feature-name`)
6. Open a Pull Request

Please read `CONTRIBUTING.md` for detailed guidelines before submitting a PR.

---

## Roadmap

- [ ] Weekly contribution graph visualization
- [ ] Contributor leaderboard and activity metrics
- [ ] Multi-repository comparison tool
- [ ] Public REST API for programmatic access
- [ ] PDF export for analysis reports
- [ ] Enhanced language and framework detection

---

## License

MIT License. See `LICENSE` for details.

---

## Contact

#### Shreyash Patel
- GitHub: [@shreyashpatel5506](https://github.com/shreyashpatel5506)
- Discord: [Community Server](https://discord.gg/YOUR_INVITE_CODE)