A production-ready scaffold for building 30 intelligent business automation agents. This repository provides a complete foundation for creating AI-powered agents that solve real-world business problems across finance, operations, marketing, HR, and more.
🌐 NEW: GitHub Data Access - Team members can now access demo data directly from GitHub without local setup!
- 30 Pre-built Agent Templates - Complete with sample data and configurations
- 🌐 GitHub Data Access - Direct access to demo data without local setup
- Next.js API Framework - Production-ready endpoints with TypeScript
- Comprehensive Test Suite - Vitest + GitHub Actions CI/CD
- Real-world Data Sets - Realistic CSV, JSON, and configuration files
- Schema Validation - Zod-powered data validation
- Multi-platform Integration - Support for 20+ external APIs
- Documentation & Examples - Detailed guides and implementation patterns
# Access any agent's demo data directly from GitHub
curl http://localhost:3000/api/github/invoice-anomalies
# Get specific data files
curl http://localhost:3000/api/github/invoice-anomalies/invoices.csv
# Direct GitHub raw URLs (work anywhere)
curl https://raw.githubusercontent.com/indranilbanerjee/hackathon-agents-starter/main/data/agents-seed-pack-full/day25_Invoice_Fraud_Anomaly_Detector/invoices.csv# Clone the repository
git clone https://github.com/indranilbanerjee/hackathon-agents-starter.git
cd hackathon-agents-starter
# Install dependencies
npm install
# Set up environment variables
cp data/agents-seed-pack-full/.env.example .env.local
# Edit .env.local with your API keys
# Start development server
npm run dev
# Run tests
npm testThis repository follows a modular architecture designed for scalability and maintainability:
├── app/api/ # Next.js API routes for agent endpoints
│ ├── agents/ # Agent registry and data access APIs
│ └── github/ # GitHub data access endpoints
├── data/ # Seed data and configurations for all agents
├── lib/ # Shared schemas and utilities
│ ├── agent-registry.ts # Central agent configuration
│ ├── data-access.ts # Local + GitHub data access
│ └── github-data-access.ts # Direct GitHub integration
├── tests/ # Comprehensive test suite
├── docs/ # Detailed documentation
└── postman/ # API collection for testing
| Agent | Description | Real-world Impact |
|---|---|---|
| Smart Payment Follow-Up | Automated invoice reminders with multi-channel escalation | Reduces DSO by 25-40% |
| Expense Parser & Categorizer | OCR + AI categorization of receipts and expenses | Saves 15+ hours/week for finance teams |
| Contract Clause Compliance | Scans contracts for compliance violations | Prevents 90% of contract disputes |
| Customer Sentiment Tracker | Monitors customer communications for sentiment shifts | Early warning system for churn |
| Client Sentiment CommsIQ | Advanced email thread sentiment analysis | Improves client retention by 30% |
| Vendor SLA Watchdog | Monitors vendor performance against SLAs | Reduces vendor disputes by 60% |
| PO-GRN-Invoice Reconciler | Three-way matching automation | Eliminates 95% of manual reconciliation |
| Agent | Description | Real-world Impact |
|---|---|---|
| Meeting Action Enforcer | Extracts and tracks action items from meetings | Increases follow-through by 80% |
| Pipeline Nurture Agent | Automated lead nurturing based on deal stage | Improves conversion rates by 35% |
| Lead Enrichment & ICP Scorer | Scores leads against Ideal Customer Profile | Increases qualified leads by 50% |
| Proposal Scope Guard | Prevents scope creep in proposals | Reduces project overruns by 40% |
| Changelog to Success Notes | Converts product updates to customer success stories | Improves feature adoption by 60% |
| SEO Issue Sentinel | Monitors and alerts on SEO issues | Prevents 90% of ranking drops |
| Landing Page Uptime & Copy Fixer | Monitors page performance and suggests improvements | Increases conversion rates by 25% |
| Social Listening Crisis Alerts | Early warning system for brand crises | Reduces crisis response time by 75% |
| Agent | Description | Real-world Impact |
|---|---|---|
| Employee Onboarding Buddy | Personalized onboarding experience automation | Improves retention by 45% |
| HR Policy QA & Triage | Instant answers to HR policy questions | Reduces HR workload by 60% |
| Security Posture Nanny | Continuous security monitoring and alerts | Prevents 85% of security incidents |
| PII Finder & Retention | Discovers and manages personal data | Ensures GDPR/CCPA compliance |
| KB Gap Filler | Identifies and fills knowledge base gaps | Reduces support tickets by 40% |
| Support Summarizer & Router | Intelligent ticket routing and summarization | Improves resolution time by 50% |
| Calendar Load Balancer | Optimizes meeting scheduling across teams | Saves 5+ hours/week per manager |
| Travel & Expense Optimizer | Finds best travel deals and manages expenses | Reduces travel costs by 30% |
| Agent | Description | Real-world Impact |
|---|---|---|
| Inventory Demand Forecaster | Predicts inventory needs using sales data | Reduces stockouts by 70% |
| Invoice Fraud Anomaly Detector | Detects suspicious invoices and payments | Prevents 95% of payment fraud |
| Compliance Calendar GST/Tax | Automated compliance deadline tracking | Eliminates missed deadlines |
| Store Review Reply Agent | Automated responses to app store reviews | Improves app ratings by 0.5+ stars |
| Internal Brief Memo Writer | Converts meeting notes to executive briefs | Saves 10+ hours/week for executives |
| Personal Focus Coach | AI-powered productivity and focus optimization | Increases productivity by 40% |
| Multi-Agent Policy Orchestrator | Coordinates multiple agents with policy enforcement | Enables complex workflow automation |
- Framework: Next.js 14 with TypeScript
- Validation: Zod schemas for type-safe data handling
- Testing: Vitest with comprehensive test coverage
- Database: Supabase (PostgreSQL) for data persistence
- AI/LLM: OpenRouter for multi-model AI access
- Monitoring: Helicone for LLM observability
- Deployment: Vercel-ready with GitHub Actions CI/CD
- 🚀 Quick Start Guide - Get up and running in 5 minutes
- 🏗️ Architecture Overview - System design and components
- 🔧 Configuration Guide - Environment variables and setup
- ⚙️ Technical Requirements & Alternatives - APIs, tools, techniques, and alternatives
- 🤖 AI Models Guide - Latest AI models, costs, and recommendations (Oct 2025)
- 🗄️ Database & Hosting Guide - Database options, hosting platforms, and cost analysis
- 📖 API Reference - Complete API documentation for all 30 agents
- 🧪 Testing Guide - Unit, integration, and E2E testing strategies
- 🚀 Deployment Guide - Production deployment (Vercel, Docker, AWS, GCP)
- 🔍 Troubleshooting Guide - Common issues, solutions, and debugging
- 🎯 Agent Development Guide - Build custom agents with GitHub data access
- 🌐 GitHub Data Access Guide - Use demo data without local setup
- 🤝 Contributing Guidelines - How to contribute to the project
- 🎬 Demo & Sharing Guide - Create demos, presentations, and share your work
- 📚 Resources Directory - APIs, tools, learning resources, and community links
- 💰 Smart Payment Follow-Up - Automate invoice payment reminders
- 📝 Meeting Action Enforcer - Extract action items from meetings
- 🔍 SEO Issue Sentinel - Monitor and optimize SEO health
- 🚨 Invoice Fraud Detector - Detect suspicious invoices with ML
- 📁 All Agent Docs - Complete documentation for all 30 agents
- Direct GitHub access - No local setup required for team members
- Automatic fallbacks - Local files → GitHub → Mock data
- Multiple access methods - API endpoints, raw URLs, structured responses
- CORS support - Works from web applications and external tools
- Real-time data - Always up-to-date with repository changes
- Type-safe API endpoints with Zod validation
- Comprehensive error handling and logging
- Rate limiting and security best practices
- Scalable database design with Supabase
- 200+ sample records per agent
- Realistic business scenarios and edge cases
- Multi-format support (CSV, JSON, XML, YAML)
- Privacy-compliant synthetic data
- GitHub-accessible - Available via direct URLs
- 20+ external API integrations
- OAuth flows for Google, Salesforce, etc.
- Webhook handling for real-time updates
- Multi-channel communication (Email, Slack, WhatsApp)
- Hot reload development environment
- Comprehensive test coverage
- Postman collections for API testing
- Detailed documentation and examples
- GitHub data access - Work without local repository
# Browse all available agents
curl http://localhost:3000/api/agents
# Get agent data directly from GitHub
curl http://localhost:3000/api/github/invoice-anomalies
# Access specific files from GitHub
curl http://localhost:3000/api/github/meeting-actions/transcript.txt
# Direct GitHub raw URLs (work anywhere)
curl https://raw.githubusercontent.com/indranilbanerjee/hackathon-agents-starter/main/data/agents-seed-pack-full/day08_Meeting_Action_Enforcer/transcript.txt# Meeting Action Enforcer
curl -X POST http://localhost:3000/api/meeting-actions \
-H "Content-Type: application/json" \
-d '{"path": "/path/to/transcript.txt"}'
# Invoice Anomaly Detection
curl http://localhost:3000/api/invoice-anomalies
# Support Ticket Summarization
curl -X POST http://localhost:3000/api/support-brief \
-H "Content-Type: application/json" \
-d '{"path": "/path/to/tickets.json"}'# Local + GitHub fallback (automatic)
curl http://localhost:3000/api/agents/invoice-anomalies/data
# Specific file with GitHub fallback
curl http://localhost:3000/api/agents/invoice-anomalies/data?file=invoices.csv
# Raw file content
curl http://localhost:3000/api/agents/invoice-anomalies/data?file=invoices.csv&format=rawWe welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with ❤️ for the developer community
- Inspired by real-world business automation needs
- Powered by cutting-edge AI and modern web technologies
Ready to build the future of business automation? 🚀