OASIS快速入门指南：5分钟搭建你的第一个社交模拟环境

OASIS快速入门指南：5分钟搭建你的第一个社交模拟环境

【免费下载链接】oasis🏝️ OASIS: Open Agent Social Interaction Simulations with One Million Agents.项目地址: https://gitcode.com/gh_mirrors/oasis2/oasis

OASIS（Open Agent Social Interaction Simulations with One Million Agents）是一个强大的开源社交模拟平台，能够快速构建包含百万级智能体的社交互动环境。本指南将帮助你在5分钟内完成从环境搭建到运行第一个社交模拟的全过程，无需复杂的编程经验。

为什么选择OASIS？

OASIS提供了一个高度可定制的社交模拟框架，支持多种社交平台类型（如Reddit、Twitter等）和丰富的智能体交互行为。无论是研究信息传播、群体极化，还是测试社交平台算法，OASIS都能提供接近真实世界的模拟环境。

图：OASIS社交模拟平台展示了信息在不同社交网络中的传播过程和群体效应

环境准备

硬件要求

• 最低配置：4核CPU，8GB内存
• 推荐配置：8核CPU，16GB内存（支持更复杂的模拟场景）

软件依赖

• Python 3.8+
• pip 21.0+
• Git

快速安装步骤

方法一：通过pip安装（推荐新手）

pip install camel-oasis

方法二：从源码安装（适合开发者）

git clone https://gitcode.com/gh_mirrors/oasis2/oasis cd oasis pip install --upgrade pip setuptools pip install -e . # 安装项目依赖（基于pyproject.toml）

提示：项目依赖管理通过pyproject.toml文件维护，确保所有依赖项都已正确安装。

第一个社交模拟：Reddit环境

配置OpenAI API（可选）

如果使用OpenAI模型，需要设置API密钥：

# Linux/macOS export OPENAI_API_KEY="你的API密钥" # Windows set OPENAI_API_KEY="你的API密钥"

运行基础模拟

创建一个Python文件，复制以下代码：

import asyncio import os from camel.models import ModelFactory from camel.types import ModelPlatformType, ModelType import oasis from oasis import ActionType, generate_reddit_agent_graph async def main(): # 创建AI模型 model = ModelFactory.create( model_platform=ModelPlatformType.OPENAI, model_type=ModelType.GPT_4O_MINI ) # 生成智能体网络 agent_graph = await generate_reddit_agent_graph( profile_path="./data/reddit/user_data_36.json", model=model, available_actions=[ActionType.CREATE_POST, ActionType.LIKE_POST] ) # 创建模拟环境 env = oasis.make( agent_graph=agent_graph, platform=oasis.DefaultPlatformType.REDDIT, database_path="./reddit_simulation.db" ) # 启动模拟 await env.reset() await env.step({ env.agent_graph.get_agent(0): oasis.ManualAction( action_type=ActionType.CREATE_POST, action_args={"content": "Hello OASIS World!"} ) }) await env.close() if __name__ == "__main__": asyncio.run(main())

运行后，你将在当前目录看到生成的数据库文件，包含模拟过程中的所有社交互动数据。

OASIS核心架构解析

OASIS采用模块化设计，主要包含以下组件：

• 智能体系统：定义社交用户的行为模式和决策逻辑
• 环境引擎：模拟社交平台的运行规则和状态更新
• 交互接口：支持智能体间的各种社交行为（发帖、评论、点赞等）

图：OASIS的强化学习实验架构，展示了智能体与环境的交互流程

进阶使用：本地模型部署

如果没有OpenAI API，可使用本地开源模型（如Qwen、Llama等）配合VLLM部署：

1. 安装VLLM：pip install vllm
2. 启动模型服务：vllm serve Qwen/Qwen2.5-7B-Instruct --port 8000
3. 修改模拟代码使用VLLM模型：

model = ModelFactory.create( model_platform=ModelPlatformType.VLLM, model_type="qwen-2", url="http://localhost:8000" )

模拟结果可视化

OASIS提供多种可视化工具，帮助分析模拟数据：

• 社交网络分析：visualization/dynamic_follow_network/
• 传播效果评估：visualization/reddit_simulation_counterfactual/

图：Reddit模拟中的反事实分析结果，展示不同条件下的信息传播差异

官方资源

• 详细文档：docs/
• 示例代码：examples/
• 测试用例：test/

通过以上步骤，你已经成功搭建了OASIS社交模拟环境。现在可以尝试修改智能体行为、调整环境参数，探索不同社交场景下的模拟结果！

【免费下载链接】oasis🏝️ OASIS: Open Agent Social Interaction Simulations with One Million Agents.项目地址: https://gitcode.com/gh_mirrors/oasis2/oasis