🤖 Agent Sterling: Advanced Social Media Interaction Assistant

Agent Sterling is a sophisticated AI-powered social media management solution that leverages Google's Gemini Pro technology to provide intelligent, context-aware interactions across multiple social media platforms.

🌐 Live Demo

Experience Agent Sterling in action: Live Demo

🎯 Key Features

Multi-Platform Integration

• Twitter Integration: Advanced Twitter API implementation
• Mastodon Support: Full federation capabilities
• Pleroma Compatibility: Extended platform support
• Platform-Specific Optimization: Tailored responses for each platform

Core Capabilities 💪

• Account Monitoring: Real-time user interaction tracking
• Mention Management: Comprehensive mention detection and response
• Trend Analysis: Dynamic hashtag monitoring and engagement
• AI-Enhanced Responses: Powered by Google Gemini Pro
• Contextual Understanding: Advanced natural language processing
• Administrative Interface: Comprehensive control panel for management

Technical Specifications 🔧

• Rate Management: Intelligent API rate limiting
• Error Resilience: Robust error handling and recovery
• Natural Language Processing: Advanced NLTK implementation
• Gemini Pro Integration: State-of-the-art language model
• Asynchronous Architecture: Efficient parallel processing
• Modular Framework: Scalable component-based design

📋 System Requirements

• Python 3.8+
• Twitter API credentials (Elevated access)
• Mastodon account and API access
• Google Gemini API key
• FastAPI framework

🔧 Installation Guide

1. Clone the repository:

git clone https://github.com/aathif_pm/Agent_Sterling.git
cd Agent_Sterling

2. Install dependencies:

pip install -r requirements.txt

3. Configure your credentials: All API credentials and configurations are managed through the web control panel UI. No .env file is required.

🎓 API Configuration Guide

Gemini Pro Setup

1. Access Google AI Studio
2. Authenticate with your Google account
3. Generate an API key
4. Configure the key in the web control panel's API section

Gemini Pro Features:

• Multimodal processing capabilities
• Extended context window (2M tokens)
• Advanced reasoning engine
• Multi-language support

Mastodon Configuration

1. Access your Mastodon instance (e.g., mastodon.social)
2. Navigate to Settings > Development > New Application
3. Configure application settings:
   • Name: Agent_Sterling
   • Required scopes: read, write, follow, push
4. Store the generated credentials in the web control panel

🚀 Deployment Instructions

Backend Service

Initialize the backend server:

uvicorn src.app:app --reload --log-level debug

Frontend Development

Environment Setup

1. Install Node.js LTS from official website
2. Verify installation:

node --version
npm --version

Development Server

npm install -g http-server
cd static
http-server

Access the control panel at http://localhost:8080

⚠️ Implementation Notes

1. Platform Status

   • Mastodon: Fully operational ✅
   • Twitter: Integration pending ⏳

2. Configuration Management

   • Web interface for credential management
   • Real-time configuration updates
   • Secure credential storage

🔧 Development Guidelines

Testing Protocol

Execute test suite:

python -m pytest test_*.py

Test Coverage:

• Core agent functionality
• Platform integration
• Response generation
• System integration

Project Architecture

src/
├── agent/         # Core agent logic
├── platforms/     # Platform integrations
├── features/      # Feature implementations
├── config/        # Configuration management
├── listener/      # Event listeners
└── setup/         # Installation utilities

🤝 Contributing

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

📄 License

This project is licensed under the MIT License.

👏 Acknowledgments

• Twitter API ecosystem
• Mastodon API framework
• Google Gemini Pro team
• FastAPI developers
• NLTK contributors
• Open source community

📧 Contact Information

Project Lead: Aathif PM - @AathifPM Project Co-Lead Mohammed Salick -@mohammedsalick

Repository: https://github.com/aathif_pm/Agent_Sterling

Live Demo: https://agent-sterling.onrender.com/