Ever wondered what your GitHub repository would sound like? GitBeat transforms code into music using AI - analyzing your repo's architecture, contributors, and development patterns to generate a unique beat that represents your project's vibe.
🎧 Try it Live | ⭐ Star this repo if you love it!
GitBeat isn't just another GitHub stats tool - it's a creative AI experience that bridges code and music:
- 🤖 Triple AI Power: Combines Dust.tt, Groq, and Suno AI for deep analysis and music generation
- 🎼 Unique Beats: Every repository gets its own custom song with vocals about the code
- 👥 Contributor Roasts: AI-powered personality profiles (fun mode gets savage!)
- 🏆 Community Leaderboard: Vote for your favorite beats and see what's trending
- ⚡ Lightning Fast: Groq's Llama 3.3 70B delivers insights in 2-3 seconds
Built for the Zeabur Ship It Hackathon 2026 🚀
Transform any GitHub repo into a custom AI-generated song. The AI analyzes your code structure, tech stack, and development patterns, then creates music that captures your project's essence.
Get deep insights powered by Groq's Llama 3.3 70B:
- Team Dynamics: How contributors work together
- Project Health: Stars, forks, activity metrics
- Contributor Personalities: AI-generated profiles (try "Fun" mode for hilarious roasts!)
- Language Breakdown: Tech stack visualization
- Vote for your favorite beats
- Real-time ranking animations
- Play songs directly in the browser
- View AI-generated lyrics for each track
- Responsive design (works on mobile!)
- Smooth animations and transitions
- Dark mode optimized
- Built with Tailwind CSS v4 and shadcn/ui
Frontend & API:
- ⚡ Next.js 15 with React 19 & TypeScript
- 🎨 Tailwind CSS v4 + shadcn/ui components
- 🚀 Deployed on Zeabur (serverless)
Database & Storage:
- 🗄️ Supabase PostgreSQL (songs, votes, repos)
- 📦 Supabase Object Storage (audio files & lyrics)
AI Services:
- 🧠 Dust.tt - Deep repository analysis with multi-step reasoning
- ⚡ Groq (Llama 3.3 70B) - Lightning-fast contributor insights (2-3s response!)
- 🎵 Suno AI - Professional music generation with vocals
User Input (GitHub URL)
↓
Dust.tt AI Agent
├─ Analyzes repository structure
├─ Examines code patterns
└─ Generates comprehensive analysis
↓
Suno AI
├─ Receives analysis as lyrics
├─ Generates music with vocals
└─ Returns audio URL
↓
Supabase
├─ Stores song metadata
├─ Saves audio & lyrics to storage
└─ Tracks upvotes
↓
Leaderboard (Real-time updates!)
- Polling System: Manages async music generation (checks status every 5s)
- Rate Limiting: Cookie-based voting limits (300/hour)
- Real-time Updates: Ranking animations on upvote changes
- Smart Truncation: Summarizes long analyses for Suno's character limit
- Node.js 18+ or Bun
- API keys for: Supabase, Dust.tt, Suno AI, Groq
# Clone the repo
git clone https://github.com/Nsuccess/gitbeat.git
cd gitbeat/frontend
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Add your API keys to .env.local
# Run database migrations
# Go to Supabase dashboard → SQL Editor
# Run the contents of supabase-schema.sql
# Start the dev server
npm run devOpen https://gitbeat.zeabur.app/ and start generating beats! 🎵
# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_publishable_key
SUPABASE_SERVICE_ROLE_KEY=your_secret_key
# AI Services
DUST_API_KEY=your_dust_api_key
DUST_WORKSPACE_ID=your_workspace_id
SUNO_API_TOKEN=your_suno_token
GROQ_API_KEY=your_groq_api_key- Go to the "Beats" tab
- Paste any GitHub repo URL (e.g.,
https://github.com/facebook/react) - Click "Analyze & Generate Beat"
- Wait ~2 minutes while AI works its magic:
- 🔍 Dust.tt analyzes the repository
- 🎵 Suno AI generates custom music
- 📝 Lyrics are created from the analysis
- Your beat appears on the leaderboard - hit play! 🎧
- Switch to "Repository Analysis" tab
- Enter a GitHub repo URL
- Choose your vibe:
- Professional: Serious insights and metrics
- Fun: Hilarious roasts and savage commentary 😂
- Get instant results in 2-3 seconds (thanks Groq!)
- Browse the leaderboard to hear other repos' beats
- Upvote your favorites (300 votes/hour limit)
- Watch real-time ranking changes
- Click "View Lyrics" to see the full AI analysis
POST /api/suno/generate- Generate music from analysisGET /api/suno/status/[taskId]- Check generation progressPOST /api/suno/callback- Webhook for completion
POST /api/dust/conversation- Deep repo analysis (Dust.tt)POST /api/analyze-contributors- Contributor insights (Groq)
GET /api/songs- Fetch all songs with upvote countsPOST /api/songs/ai-generated- Save generated songPOST /api/songs/[id]/upvote- Upvote a song (rate limited)
frontend/
├── app/
│ ├── api/ # API routes (Next.js)
│ │ ├── dust/ # Dust.tt integration
│ │ ├── suno/ # Suno AI integration
│ │ ├── songs/ # Database operations
│ │ └── analyze-contributors/ # Groq integration
│ ├── globals.css # Global styles
│ ├── layout.tsx # Root layout
│ └── page.tsx # Home page
├── components/ # React components
│ ├── BeatsAnalysis.tsx
│ ├── Leaderboard.tsx
│ ├── RepositoryAnalysis.tsx
│ └── SongCard.tsx
├── lib/
│ ├── hooks/ # Custom React hooks
│ │ └── useSunoPolling.ts
│ ├── supabase.ts # Database client
│ └── github-analysis.ts
└── public/ # Static assets
We love contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature) - 💻 Make your changes
- ✅ Test thoroughly
- 📝 Commit (
git commit -m 'Add amazing feature') - 🚀 Push (
git push origin feature/amazing-feature) - 🎉 Open a Pull Request
Ideas for contributions:
- 🎨 UI/UX improvements
- 🎵 New music generation features
- 📊 Additional analysis metrics
- 🐛 Bug fixes
- 📖 Documentation improvements
This project is licensed under the MIT License - see the LICENSE file for details.
- Zeabur for hosting and the amazing hackathon
- Dust.tt for powerful repository analysis
- Groq for lightning-fast LLM inference
- Suno AI for incredible music generation
- Supabase for seamless database & storage
- All the amazing open-source projects that made this possible!
- 🌐 Live Demo: gitbeat.zeabur.app
- 🐙 GitHub: @Nsuccess
- 🏆 Hackathon: Zeabur Ship It 2026
Made with ❤️ and AI for the Zeabur Ship It Hackathon 2026
⭐ Star this repo if you love it! ⭐