GDG Solution Hacks - GetReal Platform

GetReal Study is an innovative AI-powered platform built for the GDG Solution Hacks hackathon that combines advanced research capabilities with automated social media content generation. The platform features a sophisticated multi-agent system capable of academic research, financial analysis, political news monitoring, and AI-driven video content creation for Instagram.

The project consists of two main components:

A comprehensive FastAPI-based backend featuring:

• Multi-Agent AI System: Specialized agents for different domains
• Instagram Automation: Complete video generation and posting pipeline
• Database Management: MongoDB integration with Beanie ODM
• API-First Design: RESTful APIs with comprehensive documentation

• Routing Agent: Intelligent request routing to specialized agents
• Academic Research Agent: Paper analysis and research recommendations
• FOMC Research Agent: Financial market analysis and Fed meeting insights
• Political News Agent: Multi-source news aggregation with bias analysis

• AI Video Generation: Automated video creation using Google's Gemini AI and Captions.ai
• Instagram Integration: Complete Instagram account management and posting
• Content Optimization: AI-generated captions, hashtags, and engagement optimization
• Scheduling System: Video posting scheduler with database persistence

• MongoDB Integration: Persistent storage for users, videos, and Instagram accounts
• Session Management: Secure Instagram session handling
• File Storage: Video file management and serving
• API Schemas: Comprehensive Pydantic models for data validation

• Framework: FastAPI with async/await support
• Database: MongoDB with Beanie ODM
• AI Integration: Google ADK, Gemini AI, and Captions.ai
• Authentication: Instagram API integration with session management
• Task Scheduling: APScheduler for automated posting
• File Handling: Video upload, storage, and serving

┌─────────────────┐
│  Routing Agent  │ ──── Routes user requests intelligently
└─────────────────┘
         │
    ┌────┴────┬────────────┬─────────────┐
    │         │            │             │
┌───▼───┐ ┌──▼───┐ ┌──────▼──┐ ┌────────▼────┐
│Academic│ │FOMC  │ │Political│ │Video Content│
│Research│ │Agent │ │News     │ │Generator    │
└───────┘ └──────┘ └─────────┘ └─────────────┘

User Prompt → AI Analysis → Script Generation → Video Creation → 
Instagram Upload → Performance Tracking

GDGSolutionHacks/
├── backend/                    # Main backend application
│   ├── agents/                # All AI agents
│   │   ├── routing_agent/     # Main routing agent
│   │   ├── academic_research/ # Academic paper analysis
│   │   ├── fomc_research/     # Financial market analysis
│   │   └── political_news/    # Political news aggregation
│   ├── api/                   # API schemas and endpoints
│   ├── database/              # Database models and schemas
│   ├── managers/              # Business logic managers
│   │   ├── chat_manager.py    # Chat functionality
│   │   ├── instagram_manager.py # Instagram automation
│   │   └── vid_generator.py   # AI video generation
│   ├── storage/               # File storage for videos
│   ├── app.py                 # Main FastAPI application
│   ├── requirements.txt       # All dependencies
│   └── README.md              # Backend documentation
└── README.md                  # This file

• Intelligent Routing: Automatically determines which agent to use based on user queries
• Specialized Expertise: Each agent handles specific domains with deep knowledge
• Conversational Interface: Natural language interaction with AI agents
• Context Preservation: Maintains conversation context across interactions

• Account Management: Add, manage, and monitor multiple Instagram accounts
• AI Video Generation: Generate engaging short-form videos using AI
• Content Optimization: AI-powered captions, hashtags, and engagement strategies
• Automated Posting: Schedule and automatically post content
• Performance Tracking: Monitor follower growth and engagement metrics

• Academic Research: Analyze research papers and suggest future directions
• Financial Analysis: FOMC meeting analysis with market insights
• News Monitoring: 24/7 political news tracking with bias analysis
• Multi-Source Integration: Combines data from multiple APIs and sources

• AI Script Generation: Creates engaging scripts for social media videos
• Video Production: Automated video creation with professional quality
• Brand Consistency: Maintains consistent creator persona ("Kate")
• Trend Integration: Incorporates current social media trends and slang

• Google ADK: Agent Development Kit for building AI agents
• Google Gemini: Large language model for text generation
• Captions.ai: AI video generation service
• Multi-Modal AI: Text, image, and video processing capabilities

• FastAPI: Modern Python web framework
• MongoDB: NoSQL database for flexible data storage
• Beanie: Async Python ODM for MongoDB
• APScheduler: Task scheduling and automation
• Uvicorn: ASGI server for production deployment

• Instagram Graph API: Social media platform integration
• NewsAPI: News data aggregation
• Google Cloud: Infrastructure and AI services
• BigQuery: Data warehousing for analytics

• Poetry: Dependency management
• Pydantic: Data validation and serialization
• Pytest: Testing framework
• Docker: Containerization for deployment

• Automated Content Pipeline: Reduces content creation time by 80%
• AI-Powered Optimization: Improves engagement through AI analysis
• Multi-Platform Management: Manages multiple accounts from one interface
• Performance Analytics: Data-driven insights for content strategy

• Comprehensive Research Tools: Academic, financial, and political analysis
• Real-Time Insights: 24/7 monitoring and analysis capabilities
• Bias-Free Information: Multi-source aggregation with bias detection
• Automated Reporting: Generate detailed analysis reports automatically

• Scalable Architecture: Handles multiple users and accounts
• API-First Design: Easy integration with existing systems
• Cost-Effective: Reduces manual work and operational costs
• Data-Driven: Makes decisions based on real-time data analysis

• Python 3.11+
• MongoDB instance
• Google Cloud Project with ADK enabled
• Instagram developer account
• Various API keys (detailed in setup docs)

1. Clone the repository:

   git clone <repository-url>
   cd GDGSolutionHacks/backend

2. Set up environment:

   pip install -r requirements.txt
   cp env.example .env
   # Configure your API keys in .env

3. Run the application:

   python app.py

4. Access the API:

   • Main API: http://localhost:8000
   • Documentation: http://localhost:8000/docs
   • Chat Interface: POST /chat

# Core API Keys
GOOGLE_API_KEY=your_google_api_key
CAPTIONS_API_KEY=your_captions_api_key
MONGODB_URI=your_mongodb_connection_string

# News APIs (at least one required)
NEWSAPI_KEY=your_newsapi_key
GNEWS_API_KEY=your_gnews_api_key
MEDIASTACK_API_KEY=your_mediastack_api_key
NEWSDATA_API_KEY=your_newsdata_api_key

• POST /chat - Send message to AI agents
• GET /chat/agents - List available agents
• GET /chat/health - System health check

• POST /instagram-accounts/ - Add Instagram account
• GET /instagram-accounts/ - List all accounts
• POST /instagram-accounts/{username}/load - Load account session
• POST /instagram-accounts/{username}/update-stats - Update account statistics

• POST /videos/generate/ - Generate new video
• POST /videos/captions-tags/ - Generate captions and hashtags
• GET /videos/ - List all videos
• PUT /videos/{video_id} - Update video details
• POST /instagram-upload/ - Upload video to Instagram

The project includes comprehensive testing:

# Test agent connections
cd agents/routing_agent
python test_connection.py

# Test API endpoints
python test_chat_api.py

# Test deployment
python test_deployment.py

• Type Hints: Full Python type annotation
• Error Handling: Comprehensive exception management
• Logging: Detailed logging for debugging and monitoring
• Validation: Input validation with Pydantic models

• API Documentation: Auto-generated OpenAPI/Swagger docs
• Code Comments: Comprehensive inline documentation
• README Files: Detailed setup and usage instructions
• Architecture Diagrams: Visual system documentation

• Async Architecture: Non-blocking I/O for high performance
• Database Indexing: Optimized MongoDB queries
• Caching: Session and data caching strategies
• Modular Design: Easy to extend and maintain

• Multi-Agent Architecture: Novel approach to AI agent orchestration
• Cross-Domain Intelligence: Combines research and social media automation
• Real-Time Processing: Live data integration and analysis
• AI-Driven Content: Automated video creation with personality

• Production-Ready: Scalable architecture with proper error handling
• API-First Design: Clean, documented interfaces
• Security: Secure session management and data handling
• Performance: Optimized for speed and reliability

• Natural Language Interface: Intuitive chat-based interaction
• Automated Workflows: Minimal manual intervention required
• Real-Time Feedback: Immediate responses and status updates
• Comprehensive Features: End-to-end solution for content creators

• Web Dashboard: React-based frontend for better UX
• Advanced Analytics: Detailed performance metrics and insights
• Multi-Platform Support: Extend to TikTok, YouTube, Twitter
• Team Collaboration: Multi-user support with role management
• AI Model Training: Custom models trained on user data

• Kubernetes Deployment: Container orchestration for scalability
• Real-Time Notifications: WebSocket integration for live updates
• Advanced Caching: Redis integration for better performance
• Machine Learning Pipeline: Custom ML models for content optimization

This project was developed for the GDG Solution Hacks hackathon. The codebase is structured for easy extension and contribution:

1. Agent Development: Add new specialized agents in /agents/
2. API Extensions: Extend endpoints in /api/
3. Feature Enhancement: Improve existing managers in /managers/
4. Testing: Add tests for new functionality

This project is developed for the GDG Solution Hacks hackathon. All rights reserved.

Developed by the GDG Solution Hacks team, showcasing the power of AI agent systems and automated content creation.

Built with ❤️ for GDG Solution Hacks - Where AI meets Social Media Innovation