AI-powered founder discovery system with complete production infrastructure
Developed by: Karunasagar Mohansundar
A production-ready, AI-powered founder sourcing platform built in 30 hours to demonstrate technical competence, rapid prototyping, and scalable architecture decisions. This project showcases full-stack development, cloud deployment, and DevOps practices.
- 🤖 AI-Powered Analysis: Google Gemini AI for intelligent candidate evaluation
- 🎯 Smart Tier Ranking: A/B/C classification system for candidate prioritization
- 📊 Data Integration: Harvest API for LinkedIn profile data
- 🔐 User Authentication: JWT-based secure authentication system
- 📈 CSV Export: Professional data export functionality
- 📱 Responsive Design: Modern, mobile-first UI/UX
- 🚀 Live Deployment: Production-ready cloud infrastructure
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Firebase │ │ Cloud Run │ │ Cloud SQL │
│ Hosting │◄──►│ Backend │◄──►│ PostgreSQL │
│ (Frontend) │ │ (FastAPI) │ │ (Database) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ GitHub │ │ Secret │ │ Cloud │
│ Actions │ │ Manager │ │ Monitoring │
│ (CI/CD) │ │ (Secrets) │ │ (Logs) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- React 18 + Vite - Modern, fast development
- Tailwind CSS - Utility-first styling
- Lucide React - Beautiful icons
- React Router - Client-side routing
- FastAPI - High-performance Python web framework
- SQLAlchemy - Database ORM
- PostgreSQL - Production database
- JWT Authentication - Secure user management
- Google Gemini AI - Advanced AI analysis
- Harvest API - LinkedIn profile data
- Pydantic - Data validation
- Google Cloud Platform - Cloud infrastructure
- Firebase Hosting - Frontend deployment
- Cloud Run - Backend containerization
- Cloud SQL - Managed PostgreSQL
- GitHub Actions - CI/CD automation
- Docker - Containerization
- URL: https://founder-sourcing-agent.web.app
- Features: Custom domain, HTTPS, global CDN
- Performance: Optimized build with caching
- URL: https://founder-sourcing-agent-backend-xxxxx-uc.a.run.app
- Documentation: Auto-generated API docs
- Features: Auto-scaling, load balancing, monitoring
- Intelligent candidate analysis using Google Gemini AI
- Multi-criteria search (industry, location, experience)
- Real-time processing with progress tracking
- Tier A: Excellent matches (85%+ criteria met)
- Tier B: Good matches (60-84% criteria met)
- Tier C: Possible matches (40-59% criteria met)
- CSV export with comprehensive candidate data
- Search history tracking
- User-specific data persistence
- JWT-based authentication
- Secure API key management
- CORS configuration
- Environment-based security
- Automated CI/CD with GitHub Actions
- Zero-downtime deployments
- Containerized microservices
- Auto-scaling infrastructure
- Production logging and monitoring
- Health check endpoints
- Database connection pooling
- Automatic backups
- Scale-to-zero when not in use
- Resource limits and monitoring
- Efficient caching strategies
- Optimized database queries
- Node.js 18+
- Python 3.11+
- Docker (for production)
- Google Cloud SDK
-
Clone the repository
git clone https://github.com/Karunasagar12/founder-sourcing-agent.git cd founder-sourcing-agent -
Frontend Setup
cd frontend npm install npm run dev -
Backend Setup
cd backend pip install -r requirements.txt uvicorn main:app --reload -
Environment Variables
# Create .env files with your API keys HARVEST_API_KEY=your_harvest_api_key GOOGLE_GEMINI_API_KEY=your_gemini_api_key
The application is automatically deployed via GitHub Actions:
- Push to main branch
- GitHub Actions builds and deploys
- Frontend deploys to Firebase Hosting
- Backend deploys to Cloud Run
- Database migrations run automatically
founder-sourcing-agent/
├── frontend/ # React frontend application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page components
│ │ ├── services/ # API services
│ │ └── contexts/ # React contexts
│ └── public/ # Static assets
├── backend/ # FastAPI backend application
│ ├── services/ # Business logic services
│ ├── models/ # Data models
│ ├── auth/ # Authentication modules
│ └── exports/ # Generated exports
├── deployment/ # Production deployment configs
│ ├── backend/ # Docker & Cloud Run configs
│ ├── frontend/ # Firebase hosting configs
│ └── .github/ # GitHub Actions workflows
└── docs/ # Documentation
- ✅ Live deployment with custom domain
- ✅ Automated CI/CD pipeline
- ✅ Containerized microservices
- ✅ Auto-scaling infrastructure
- ✅ Production monitoring and logging
- ✅ Database migrations and backups
- ✅ Security best practices implementation
- ✅ GitHub Actions automation
- ✅ Docker containerization
- ✅ Cloud-native architecture
- ✅ Environment management
- ✅ Secret management
- ✅ Health checks and monitoring
- ✅ Type-safe development
- ✅ API documentation (auto-generated)
- ✅ Responsive design
- ✅ Modern UI/UX
- ✅ Performance optimization
- ✅ Code quality standards
This project was built as a technical demonstration and portfolio piece. For questions or collaboration opportunities, please reach out to Karunasagar Mohansundar.
This project is licensed under the MIT License - see the LICENSE file for details.
Karunasagar Mohansundar
- GitHub: @Karunasagar12
- LinkedIn: Connect with me
- Portfolio: View my work
Healthcare Data Scientist turned Entrepreneurial Builder with expertise in:
- AI/ML (Python, PyTorch, predictive analytics)
- Full-stack Development (React, FastAPI, cloud deployment)
- DevOps (CI/CD, containerization, cloud infrastructure)
- Healthcare Technology (digital health tools, data science)
This project demonstrates:
- Rapid prototyping capabilities
- Production deployment skills
- Cloud architecture expertise
- AI integration proficiency
- Professional development practices
Built in 30 hours to showcase technical competence and rapid development capabilities.
🚀 Ready to build something amazing together?