Riona AI 代理

网站 | 路线图 | Twitter | 联系

Riona AI 代理是一个基于人工智能的社交自动化平台，适用于Instagram和X/Twitter。它结合了浏览器自动化、AI生成内容、账号工作流、日程安排、互动操作以及训练输入，让您只需一个代码库即可运行社交媒体运营。

概览

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

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

快速链接

• 实时网站：https://www.agentriona.xyz
• 代币简称：$RIONA
• 合约地址：smuCA77z3nkWKH7CUP7FVVDi5AnDoQY5pXEqksmpump
• 项目路线图：ROADMAP.md

如果您想支持该项目，请查看本地维护的私人捐赠文件。

训练输入

在运行自动化之前，您可以通过以下方式塑造代理：

• YouTube视频URL
• 音频文件
• 投资组合或网站链接
• 包括PDF、DOC、DOCX和TXT在内的文档和文本文件

功能概要

• 带有Cookie的Instagram自动化，支持重新登录、发帖、日程安排和互动
• 使用模式引导回复的AI生成标题和评论
• 支持多账号和基于个人资料的操作
• 基于MongoDB的状态、摘要和速率限制控制
• 简单的仪表板，用于显示运行时健康状况和最新活动
• 日志记录、环境验证和实用脚本，方便运维

计划扩展

• 完整覆盖X/Twitter工作流
• GitHub自动化
• 更多分析、报告和合规性控制

安装

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 设置环境变量： 将根目录中的.env.example文件重命名为.env，并添加您的Instagram凭据。请参考.env.example文件获取所需变量。

   IGusername=您的Instagram用户名
   IGpassword=您的Instagram密码
   
   Xusername= #Twitter用户名
   Xpassword= #Twitter密码
   
   MONGODB_URI= #MongoDB URI
   MONGODB_REQUIRED=false
   
   # Gemini API密钥（仅设置您使用的密钥）
   GEMINI_API_KEY=您的主要Gemini API密钥
   GEMINI_API_KEY_1=您的Gemini API密钥1
   GEMINI_API_KEY_2=您的Gemini API密钥2
   
   # 可选：特定语言的广告/赞助标记（用逗号分隔）
   IG_AD_MARKERS=赞助,付费合作,付费合作与
   IG_AD_BUTTON_MARKERS=了解更多,立即购买,注册,立即安装,获取优惠,订阅,立即预订
   
   # 可选：自动运行Instagram代理循环
   IG_AGENT_ENABLED=false
   IG_AGENT_INTERVAL_MS=30000
   
   # 可选：IG行动每日最大次数（点赞/评论）。0表示无限制
   IG_DAILY_MAX_ACTIONS=0
   
   # 可选：日志后端（“winston”或“console”）
   LOGGER=console
   

MongoDB设置（使用Docker）

1. 安装Docker： 如果您尚未安装Docker，请从官方网站下载并安装。

2. 使用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容器时数据丢失或被清除，请使用此选项）

3. 修改.env文件中的MONGODB_URI：

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

4. 验证连接： 打开一个新的终端，运行以下命令：

   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
     

使用方法

1. 运行代理：

   npm start
   

   注意：代理的具体平台（Instagram、Twitter）和执行的操作通常通过.env文件中的环境变量配置，或者在应用运行时提示选择。

2. 登录并通过API触发互动：

   curl -X POST http://localhost:3000/api/login \
     -H "Content-Type: application/json" \
     -d '{"username":"YOUR_IG_USERNAME","password":"YOUR_IG_PASSWORD"}'
   

   curl -X POST http://localhost:3000/api/interact \
     -H "Content-Type: application/json" \
     --cookie "token=YOUR_JWT_TOKEN"
   

3. 可选：自动运行Instagram代理循环 在.env中将IG_AGENT_ENABLED=true设置为启用，以持续运行互动循环。

4. 发布照片（通过URL）：

   curl -X POST http://localhost:3000/api/post-photo \\
     -H "Content-Type: application/json" \\
     --cookie "token=YOUR_JWT_TOKEN" \\
     -d '{"imageUrl":"https://example.com/photo.jpg","caption":"Hello IG!"}'
   

5. 发布照片（文件上传）：

   curl -X POST http://localhost:3000/api/post-photo-file \\
     -H "Content-Type: multipart/form-data" \\
     --cookie "token=YOUR_JWT_TOKEN" \\
     -F "image=@/path/to/photo.jpg" \\
     -F "caption=Hello IG!"
   

6. 安排照片发布时间：

   curl -X POST http://localhost:3000/api/schedule-post \\
     -H "Content-Type: application/json" \\
     --cookie "token=YOUR_JWT_TOKEN" \\
     -d '{"imageUrl":"https://example.com/photo.jpg","caption":"Scheduled post","cronTime":"0 9 * * *"}'
   

仪表板

打开http://localhost:3000/dashboard以查看实时状态和最近的IG运行摘要。

开发

• 运行测试：npm test
• 格式化：npm run format
• 环境检查：npm run check:env
• 设置检查：npm run setup

指南

• Guides/Instagram-Bot.md
• Guides/Operations.md
• Guides/API.md
• Guides/Env.md
• Guides/Testing.md
• Guides/CI.md
• Guides/FAQ.md
• Guides/Logging.md
• Guides/Scripts.md
• Guides/Training.md

reCAPTCHA 模型

此仓库现已在 riona-recaptcha-model/ 下包含 reCAPTCHA 模型，并通过根脚本运行：

• npm run recaptcha:dev
• npm run recaptcha:train
• npm run recaptcha:collect
• npm run recaptcha:build
• npm run recaptcha:serve

IG 运行配置文件

设置 IG_RUN_PROFILE 以调整行为：

• safe：较慢，动作较少
• standard：平衡（默认）
• aggressive：较快，限制更高

覆盖项：

• IG_DAILY_MAX_ACTIONS
• IG_MAX_POSTS_PER_RUN
• IG_ACTION_DELAY_MIN_MS
• IG_ACTION_DELAY_MAX_MS
• IG_AGENT_INTERVAL_MS

冷却模式

如果 IG 触发挑战或登录错误，代理将进入冷却状态并跳过交互。 可通过以下方式配置：

• IG_COOLDOWN_MINUTES

手动触发：

POST /api/cooldown { "minutes": 60 }

评论过滤器

使用允许/拒绝列表和简单的情感门控：

• IG_COMMENT_ALLOWLIST
• IG_COMMENT_DENYLIST
• IG_COMMENT_SENTIMENT = any | positive | neutral

多账号支持

根据 src/config/accounts.example.json 创建 src/config/accounts.json（未提交）。 然后在 /api/login 中传递 account 以选择要使用的账号。

项目政策

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• LICENSE

项目结构

• src/client：包含与 Instagram 等社交媒体平台交互的主要逻辑。
• src/config：配置文件，包括日志记录器的设置。
• src/utils：用于处理错误、Cookie、数据保存等的实用函数。
• src/Agent：包含 AI 代理逻辑和训练脚本。
• src/Agent/training：AI 代理的训练脚本。
• src/Agent/schema：AI 生成内容和数据库模型的模式定义。
• src/test：包含测试数据和脚本，例如示例推文。

日志记录

该项目使用自定义日志记录器记录信息、警告和错误。日志保存在 logs 目录中。

错误处理

已设置进程级错误处理器，以捕获未处理的 Promise 拒绝、未捕获的异常和进程警告。错误会通过自定义日志记录器进行记录。

贡献

欢迎贡献！请 fork 仓库并提交包含您更改的拉取请求。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

星标用户

感谢所有支持我们的朋友！

由 David Patrick 用 ❤️ 构建

社区与联系

• GitHub 讨论：使用“讨论”选项卡进行问答
• 问题：报告 bug 和提出功能需求
• Twitter：@david_patrick01
• 邮箱：davidchuksdev@gmail.com

实时聊天功能尚未启用。如果您希望创建 Discord 服务器，请发起讨论，我们将根据兴趣搭建。

Riona AI Agent 中文快速上手指南

环境准备

• 系统要求：Windows / macOS / Linux（推荐 Linux 环境）
• 前置依赖：
  • Node.js v18+（推荐使用 nvm 管理版本）
  • npm（随 Node.js 安装）
  • Docker（用于 MongoDB，推荐使用国内镜像加速）

✅ 推荐使用阿里云 Docker 镜像加速：
编辑 /etc/docker/daemon.json（Linux/macOS）或 Docker Desktop 设置中添加：

{
  "registry-mirrors": ["https://registry.docker-cn.com"]
}

重启 Docker 服务生效。

安装步骤

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 配置环境变量： 复制示例配置并填写你的信息：

   cp .env.example .env
   

   编辑 .env 文件，至少填写以下字段：

   IGusername=你的Instagram用户名
   IGpassword=你的Instagram密码
   MONGODB_URI=mongodb://localhost:27017/instagram-ai-agent
   GEMINI_API_KEY=你的Gemini API密钥
   

4. 启动 MongoDB（推荐 Docker）：

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

基本使用

1. 启动代理服务：

   npm start
   

2. 登录 Instagram 账号（API 方式）：

   curl -X POST http://localhost:3000/api/login \
     -H "Content-Type: application/json" \
     -d '{"username":"你的Instagram用户名","password":"你的Instagram密码"}'
   

3. 发布一张图片（示例）：

   curl -X POST http://localhost:3000/api/post-photo \
     -H "Content-Type: application/json" \
     --cookie "token=上一步返回的JWT令牌" \
     -d '{"imageUrl":"https://example.com/photo.jpg","caption":"Hello from Riona!"}'
   

4. 访问控制面板（查看运行状态）： 打开浏览器访问：http://localhost:3000/dashboard

💡 默认启用 Instagram 自动化，如需开启自动循环互动，请在 .env 中设置：
IG_AGENT_ENABLED=true