Riona AI Agent is a Node.js/TypeScript automation tool for Instagram and Twitter, streamlining social media interactions like posting, liking, and commenting. It targets users seeking efficient social media management, offering AI-driven content generation and features for multi-account handling and session persistence.

How It Works

Built with Node.js and TypeScript, the agent integrates Google Generative AI (Gemini API) for content creation. It automates direct platform interactions, supporting proxy usage for multi-account management and rate limit avoidance, alongside cookie management for session persistence. An optional MongoDB instance can be configured for data storage.

Quick Start & Requirements

Installation requires cloning the repo, running npm install, and configuring environment variables in a .env file with credentials and API keys. MongoDB setup is facilitated via Docker. The agent is launched with npm start. Prerequisites include Node.js, npm, and Docker. API interaction examples and a dashboard at http://localhost:3000/dashboard are provided.

Highlighted Details

• AI Content Generation: Utilizes Google Generative AI for captions and comments.
• Platform Automation: Automates posting, liking, commenting, and retweeting on Instagram and Twitter.
• Advanced Management: Features proxy support, cookie management, and multi-account configuration.
• reCAPTCHA Model: Includes a dedicated reCAPTCHA model.
• Configurable Behavior: Offers run profiles (safe, standard, aggressive) and cooldown modes.
• API & Dashboard: Provides API endpoints and a monitoring dashboard.

Maintenance & Community

Maintained by David Patrick, contributions are welcome via pull requests. Support is available through GitHub Discussions, Twitter (@david_patrick01), and email (davidchuksdev@gmail.com). A Discord server is a possibility based on interest.

Licensing & Compatibility

Licensed under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

The project is actively evolving with planned features like GitHub automation. Real-time chat is not yet implemented. Setup requires careful environment variable configuration and potentially Docker.