Skip to content

Atypical-Playworks/codoi

Repository files navigation

Codoi Logo

Codoi

AI-powered GitHub repository analyzer. Crafted with Firebase Studio, Github Copilot, and the care of a human developer named Milumon

MIT License Next.js TypeScript

Live DemoDeployment GuideVibe Coding MethodologyReport Bug


🎯 What is Codoi?

Codoi is an AI-powered platform that transforms GitHub repositories into comprehensive human insights. Beyond metrics and commits, Codoi reveals the person behind the code — their expertise, collaboration style, and growth potential.

Codoi Interface

For Everyone

  • 👔 Recruiters: See cultural fit, verified skills, and collaboration style
  • 💻 Engineers: Understand architecture decisions, code quality, and technical depth
  • 🚀 Developers: Get personalized 90-day roadmaps based on real gaps in your work

✨ Key Features

  • 🧠 AI-Powered Analysis: Uses Google Gemini 2.0 Flash for deep codebase understanding
  • 🎯 Three Perspectives: Human, Technical, and Growth insights in one analysis
  • Instant Results: Complete analysis in under 60 seconds
  • 🔒 Privacy First: Only reads public repositories, zero data storage
  • 🆓 Forever Free: No sign-up required, no hidden costs

🚀 Quick Start

# Install dependencies
pnpm install

# Set up environment variables
cp .env.example .env.local
# Add your Firebase and Google AI credentials

# Start development server
pnpm dev

Visit http://localhost:3000 and paste any GitHub repository URL.


🏗️ Architecture

Built with modern, production-ready technologies:

  • Next.js 15 - React framework with App Router and Server Components
  • TypeScript - End-to-end type safety
  • Firebase - Firestore for analysis caching
  • Google Gemini AI 2.0 Flash - Advanced AI analysis engine
  • Tailwind CSS + shadcn/ui - Beautiful, accessible components
  • Clean Architecture - SOLID principles, scalable structure

📖 How It Works

  1. Enter GitHub URL - Paste any public repository
  2. Select Time Range - Choose analysis period (6 months to all time)
  3. AI Analysis - Codoi processes commits, code structure, and patterns
  4. Three Perspectives - View Human, Technical, and Growth insights
  5. Personalized Roadmap - Get 90-day learning plan based on real gaps

🎨 Design Philosophy

Codoi follows the principles of:

  • Gil Huybrecht: Emotion leads to action. Every interaction delights.
  • Jony Ive: Form follows function. Clarity through simplicity.
  • Human-First: Technology serves people, not the other way around.

The interface is minimal, confident, and elegant — letting insights speak for themselves.


🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.


📄 License

MIT License - Open Source

Codoi is free and open source software. Feel free to use, modify, and distribute it.

See the LICENSE file for details.


🙏 Credits

Built for those who need it. By someone who did.

I built this to discover what I needed to improve before contributing to open source, and to understand how other developers bring their projects to life.

A project by Atypical-Playworks
Developed by Milumon