David-patrick-chuks/Riona-AI-Agent

Riona Ai Agent 🌸 is built using Node.js and TypeScript 🛠️, designed for seamless job execution 📸. It's lightweight, efficient, and still evolving 🚧—exciting new features coming soon! 🌟

GAI 中文摘要

Riona AI Agent 是一个基于 Node.js 和 TypeScript 构建的社交媒体自动化平台，旨在通过集成浏览器自动化与 Gemini AI 模型，为 Instagram 和 X/Twitter 等平台提供从内容生成到互动管理的一站式操作解决方案。该项目通过统一的代码库实现对社交账号的精细化管控，帮助用户高效处理发布、互动与数据采集等任务。

支持 Instagram 的登录、发帖、点赞、评论及粉丝数据采集等全流程自动化操作。集成 Gemini AI 技术，能够根据用户提供的训练资料自动生成高质量的社交文案与评论内容。支持通过 YouTube 视频、音频文件、网站链接及各类文档进行 Agent 行为特征训练。内置多账号管理、任务调度、限流控制以及基于 MongoDB 的状态存储与运行监测仪表盘。包含专门的机器学习子项目，用于处理复杂的社交平台 reCAPTCHA 验证机制。

适用于需要运营多个社交账号或希望通过 AI 自动化提升内容产出与互动效率的社交媒体经理、开发者及独立创作者，常用于品牌自动化推广或个人账号的日常维护。

⭐

4.2k

Stars

🔱

814

Forks

👁

101

Watchers

📋

Issues

HTMLMIT创建于 2025/1/11更新于 2 天前

在 GitHub 上查看

README

由 Gemini 翻译整理

Riona AI Agent

网站 | 路线图 | Twitter | 联系方式

Riona AI Agent 是一个基于 AI 的社交媒体自动化平台，支持 Instagram 和 X/Twitter。它结合了浏览器自动化、AI 内容生成、账户工作流、任务调度、互动操作以及训练输入等功能，让你能够通过单一代码库管理社交媒体运营。

概述

Riona 的设计旨在实现社交活动的自动化，同时保持控制界面的清晰可见。该项目包含：

Instagram 自动化：支持登录、发帖、点赞、评论、私信及粉丝抓取
X/Twitter 支持：正在开发中，涵盖发布和互动工作流
AI 内容生成：使用 Gemini 生成标题和评论
训练输入：支持 YouTube 视频、音频、文件及网站内容
功能集成：API 端点、健康检查、仪表板、冷却时间管理、摘要和日志记录
独立的 reCAPTCHA ML 子项目，位于 riona-recaptcha-model/

快速链接

在线网站：https://www.agentriona.xyz
项目路线图：ROADMAP.md

如果你想支持本项目，请查看本地保存的私人捐赠文件。

训练输入

在运行自动化任务之前，你可以通过以下方式塑造 Agent 的行为：

YouTube 视频链接
音频文件
作品集或网站链接
文档和文本文件（包括 PDF、DOC、DOCX 和 TXT）

功能摘要

Instagram 自动化：包含 Cookie 管理、重新登录处理、发帖、调度和互动功能
AI 生成内容：利用模式引导（schema-guided）生成标题和评论
多账户支持：支持基于配置文件的多账户操作
状态管理：由 MongoDB 提供支持，具备摘要生成和速率限制控制功能
简单仪表板：用于监控运行状况和最新活动
运维工具：提供日志记录、环境验证和工具脚本

扩展计划

完善 X/Twitter 工作流覆盖
GitHub 自动化支持
增强分析、报告和合规性控制

安装指南

克隆仓库:

git clone https://github.com/david-patrick-chuks/riona-ai-agent.git
cd riona-ai-agent

安装依赖:
```
npm install
```

设置环境变量: 将根目录下的 .env.example 文件重命名为 .env，并添加你的 Instagram 凭证。请参考 .env.example 文件了解所需的变量。

IGusername=your_instagram_username
IGpassword=your_instagram_password 

Xusername= #Twitter username
Xpassword= #Twitter password

MONGODB_URI= #MongoDB URI
MONGODB_REQUIRED=false

# Gemini API keys (set only the ones you use)
GEMINI_API_KEY=your_primary_gemini_api_key
GEMINI_API_KEY_1=your_gemini_api_key_1
GEMINI_API_KEY_2=your_gemini_api_key_2

# Optional: locale-specific ad/sponsored markers (comma-separated)
IG_AD_MARKERS=sponsored,paid partnership,paid partnership with
IG_AD_BUTTON_MARKERS=learn more,shop now,sign up,install now,get offer,subscribe,book now

# Optional: run Instagram agent loop automatically
IG_AGENT_ENABLED=false
IG_AGENT_INTERVAL_MS=30000

# Optional: daily limit for IG actions (likes/comments). 0 = unlimited
IG_DAILY_MAX_ACTIONS=0

# Optional: logging backend ("winston" or "console")
LOGGER=console

MongoDB 设置 (使用 Docker)

安装 Docker: 如果尚未安装 Docker，请从官方网站下载并安装。

使用 Docker 容器运行 MongoDB:

选项 1:

docker run -d -p 27017:27017 --name instagram-ai-mongodb mongodb/mongodb-community-server:latest

选项 2:

docker run -d -p 27017:27017 --name instagram-ai-mongodb -v mongodb_data:/data/db mongodb/mongodb-community-server:latest

（选项 2：如果你希望实现持久化存储，以便在停止或删除 Docker 容器后数据不丢失，请使用此选项）

修改 .env 文件中的 MONGODB_URI:

MONGODB_URI=mongodb://localhost:27017/instagram-ai-agent

验证连接: 打开新终端并运行以下命令：
```
docker ps
```
你应该能看到 MongoDB 容器正在运行。

Docker 命令（附加信息）：
- 停止 MongoDB 容器：
```
docker stop instagram-ai-mongodb
```
- 启动 MongoDB 容器：
```
docker start instagram-ai-mongodb
```
- 移除 MongoDB 容器：
```
docker rm instagram-ai-mongodb
```
- 移除 MongoDB 容器及其数据：
```
docker rm -v instagram-ai-mongodb
```

使用方法

运行 Agent:
```
npm start
```
注意：Agent 执行的具体平台（Instagram、Twitter）及相关操作，通常在 .env 文件中配置。