https://github.com/andriamahay11master/devscope
An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.
https://github.com/andriamahay11master/devscope
axios fastapi framer-motion python react react-router recharts rest-api tailwindcss vite
Last synced: 20 days ago
JSON representation
An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.
- Host: GitHub
- URL: https://github.com/andriamahay11master/devscope
- Owner: Andriamahay11master
- Created: 2026-05-28T05:55:07.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-28T06:44:39.000Z (27 days ago)
- Last Synced: 2026-05-28T08:13:07.211Z (27 days ago)
- Topics: axios, fastapi, framer-motion, python, react, react-router, recharts, rest-api, tailwindcss, vite
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DevScope
An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.
---
## ๐ Features
- ๐ Search any GitHub developer profile
- ๐ Interactive analytics dashboard
- ๐ง AI-generated developer insights
- ๐ Repository explorer
- ๐ Most used programming languages
- โญ Stars, forks, followers, and activity metrics
- ๐ Charts and visual statistics
- ๐ Dark / Light mode
- โก Fast and responsive interface
---
## ๐ ๏ธ Tech Stack
### Frontend
- React
- Vite
- TailwindCSS
- Axios
- React Router
- Framer Motion
- Recharts
### Backend
- FastAPI
- Python
- GitHub REST API
### Deployment
- Frontend: Vercel
- Backend: Render
---
## ๐ Project Structure
```bash
DevScope/
โโโ client/
โโโ server/
```
---
## ๐งฉ Architecture
```text
React Frontend
โ
FastAPI REST API
โ
GitHub REST API
```
---
## ๐ธ Planned Dashboard Analytics
- Total repositories
- Total stars
- Followers & following
- Most used languages
- Repository activity
- Most starred repositories
- Account creation timeline
- AI profile summary
---
## โ๏ธ Installation
### 1. Clone the repository
```bash
git clone https://github.com/yourusername/devscope.git
cd devscope
```
---
## ๐ฅ๏ธ Frontend Setup
```bash
cd client
npm install
npm run dev
```
Frontend runs on:
```bash
http://localhost:5173
```
### ๐งช Run Frontend Tests
```bash
cd client
npm run test
```
Run test for one component:
```bash
cd client
npm run test -- src/components/loader/Loader.test.tsx
```
Run tests in interactive mode:
```bash
npm run test:ui
```
Generate coverage report:
```bash
npm run coverage
```
---
## ๐ง Backend Setup
```bash
cd server
python -m venv venv
```
### Activate virtual environment
#### Windows
```bash
venv\Scripts\activate
```
#### macOS / Linux
```bash
source venv/bin/activate
```
### Install dependencies
```bash
pip install -r requirements.txt
```
### Run FastAPI server
```bash
uvicorn app.main:app --reload
```
Backend runs on:
```bash
http://localhost:8000
```
---
## ๐ Environment Variables
Create a `.env` file inside the `server/` folder.
```env
GITHUB_TOKEN=your_github_token
```
---
## ๐ API Endpoint Example
```http
GET /api/github/{username}
```
Example:
```http
GET /api/github/gaearon
```
---
## ๐ฏ Project Goals
- Practice REST API integration
- Learn full-stack architecture
- Build production-ready React applications
- Integrate AI into developer tooling
- Create a strong portfolio project
---
## ๐ง Roadmap
### Version 1
- [x] Project setup
- [ ] GitHub user search
- [ ] Profile dashboard
- [ ] Repository listing
### Version 2
- [ ] Charts and analytics
- [ ] AI-generated summaries
- [ ] Favorites system
- [ ] Authentication
### Version 3
- [ ] Compare multiple developers
- [ ] Export analytics reports
- [ ] Team analytics dashboard
---
## ๐ค Contributing
Contributions, ideas, and feedback are welcome.
---
## ๐ License
This project is licensed under the MIT License.