Your AI-Powered Senior Architect in Your Pocket

Instant GitHub repository analysis, architectural diagrams, and bug fixes powered by Google Gemini 2.5 Flash-Latest. Free, unlimited, in-depth.

Check out our Canva presentation to see the full vision and pitch:

RepoRecon is a cutting-edge web application that leverages Google's Gemini AI to perform deep architectural analysis of GitHub repositories. Simply paste a repo URL, and watch as our AI:

• 📊 Generates comprehensive summaries of your codebase architecture
• 🎨 Creates beautiful Mermaid diagrams visualizing your project structure
• 🐛 Detects architectural issues and potential bottlenecks
• 💡 Provides actionable recommendations for code improvements
• ⚡ Processes everything in seconds with zero configuration

Perfect for code reviews, onboarding, architecture planning, and hackathon showcases!

• Powered by Google Gemini 2.5 Flash-Latest with 2M token context window
• Analyzes entire repositories without chunking or loss of understanding
• Lightning-fast processing on the free tier

• Auto-generated Mermaid.js sequence diagrams for architecture flow
• Interactive, responsive diagrams that work on all devices
• Dark mode optimized for developer comfort

• Download analysis as PDF with one click
• Share findings with your team instantly
• Professional report formatting

• Sleek, dark-themed interface with glassmorphism design
• Smooth animations and transitions
• Fully responsive (mobile, tablet, desktop)
• Light/Dark theme toggle

Technology	Purpose	Logo
React 18	UI Framework
TypeScript	Type Safety
Vite	Build Tool
Tailwind CSS	Styling
Framer Motion	Animations
Mermaid.js	Diagrams
Shadcn/ui	Components
html2canvas	PDF Export
jsPDF	PDF Generation

Technology	Purpose	Logo
Django	Web Framework
Python	Language
Google Gemini API	AI Analysis
Requests	HTTP Client
CORS	Cross-Origin Support

• Node.js 18+ (Frontend)
• Python 3.11+ (Backend)
• Google Gemini API Key (Get one free)
• Git

git clone https://github.com/ASaha-os/RepoRecon.git
cd RepoRecon

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

The frontend will be available at http://localhost:5173

cd backend

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Create .env file
cp .env.example .env

# Add your Google Gemini API key to .env
# GEMINI_API_KEY=your_api_key_here

# Run migrations
python manage.py migrate

# Start Django server
python manage.py runserver

The backend will be available at http://localhost:8000

1. Open RepoRecon in your browser (http://localhost:5173)
2. Paste a GitHub repository URL (e.g., https://github.com/username/repo)
3. Click "Analyze Repo" and watch the magic happen ✨
4. Review the analysis:
   • 📝 Architecture summary
   • 🎨 Visual diagram
   • 🐛 Detected issues
   • 💡 Recommendations
5. Download as PDF to share with your team

• https://github.com/facebook/react
• https://github.com/torvalds/linux
• https://github.com/nodejs/node

RepoRecon/
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   │   ├── landing/
│   │   │   │   ├── HeroSection.tsx
│   │   │   │   ├── FeatureGrid.tsx
│   │   │   │   ├── HowItWorks.tsx
│   │   │   │   ├── AnalysisResults.tsx
│   │   │   │   └── Footer.tsx
│   │   │   └── ui/
│   │   ├── pages/
│   │   ├── App.tsx
│   │   └── main.tsx
│   ├── package.json
│   ├── vite.config.ts
│   └── tailwind.config.ts
│
├── backend/
│   ├── core/
│   │   ├── views.py
│   │   ├── urls.py
│   │   ├── gemini_service.py
│   │   └── migrations/
│   ├── backend/
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   ├── manage.py
│   ├── requirements.txt
│   ├── .env.example
│   └── db.sqlite3
│
├── README.md
├── .gitignore
└── package.json

# Google Gemini API Configuration
GEMINI_API_KEY=your_api_key_here

# Django Settings
DEBUG=True
SECRET_KEY=your_secret_key_here
ALLOWED_HOSTS=localhost,127.0.0.1

# CORS Settings
CORS_ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000

• Fetches README and project structure from GitHub
• Cleans and optimizes content for AI processing
• Handles both main and master branch repositories
• Graceful error handling for private/missing repos

• Converts architecture into Mermaid sequence diagrams
• Handles complex multi-component systems
• Fallback to raw code if rendering fails
• Responsive and interactive

• Executive summary of codebase
• Architectural patterns identified
• Security and performance issues
• Best practice recommendations
• Professional PDF export

⚠️ AI Limitations: This analysis is generated by AI and may occasionally produce inaccurate or incomplete results. If you encounter unexpected output, please refresh the page or try again after a brief interval.

⚠️ Free Tier: As this service operates on a free tier, intermittent errors or rate limiting may occur during high-traffic periods.

We love contributions! Here's how you can help:

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

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ by Akash Saha

• GitHub: @ASaha-os
• LinkedIn: Akash S

• 🤖 Google Gemini AI
• ⚛️ React
• 🎨 Tailwind CSS
• 🐍 Django

RepoRecon was built with the spirit of innovation and the goal of making code analysis accessible to everyone. Whether you're a solo developer, a startup, or an enterprise team, RepoRecon helps you understand your codebase faster and make better architectural decisions.

Built for: Developers who love clean code, beautiful UIs, and AI-powered insights.

Perfect for: Code reviews, onboarding, architecture planning, and impressing your team! 🚀

Have questions or found a bug?

• 🐛 Open an Issue
• 💬 Start a Discussion
• 📧 Reach out on LinkedIn