Epitome
Pioneering an Experimental Platform for AI-Social Science Integration
๐ English โข
๐จ๐ณ ไธญๆ โข
๐ arXiv โข
๐ Website
---
## ๐ Table of Contents
- [Introduction](#-introduction)
- [Key Features](#-key-features)
- [Tech Stack](#-tech-stack)
- [Requirements](#-requirements)
- [Quick Start](#-quick-start)
- [Project Structure](#-project-structure)
- [Configuration Guide](#-configuration-guide)
- [Other](#-other)
- [License](#-license)
- [Contact Us](#-contact-us)
- [Citation](#-citation)
---
## ๐ฏ Introduction
**Epitome** is the world's first experimental open platform dedicated to the deep integration of artificial intelligence and social sciences. Through seven major modules, the platform provides intelligent assistance across the entire processโranging from **experimental intervention, experimental environment, to experimental participants**โhelping researchers easily design and conduct complex human-computer interaction experimental scenarios. This enables systematic research on AI's social impact and exploration of comprehensive solutions, advancing the harmonious integration of artificial intelligence into human society.
For more information, please refer to [the introduction video](https://youtu.be/i7WFY5xNJ_c).
### ๐ Application Scenarios
- Social science experimental research
- Human-computer interaction behavior analysis
- AI social impact assessment
- Group dynamics simulation
- Interdisciplinary experimental design
---
## โจ Key Features
### ๐ญ Innovative Interactive Scenarios
#### Role-Playing Robots
- ๐ค Simulate diverse social roles such as judges and historical figures
- ๐ Enable cross-temporal and cross-identity dialogue experiments
- ๐ Provide standardized and replicable interactive elements for abstract social problem research
#### Human-AI Hybrid Chat Rooms
- ๐ฅ Support multi-party interaction patterns of "human-human-AI-AI"
- ๐ Simulate complex social networks and group interaction contexts
- ๐ฌ Open new possibilities for group behavior and social dynamics research
#### Social Simulation
- ๐ผ Simulate human economic transactions, social conflicts, and other behaviors through intelligent agents
- โฑ๏ธ Provide large-scale, long-term social scenario simulations
- ๐ฐ Enable low-cost policy effect prediction and social norm evolution research
### ๐ Complete-Flow Closed-Loop Support
- **๐ฏ Experiment Management**: Complete lifecycle management from design to execution
- **๐ฆ Material Management**: Centralized management of multimodal experimental materials
- **๐ Questionnaire Management**: Flexible questionnaire design and data collection
- **โ๏ธ Workflow Management**: Visual orchestration of modular components
- **๐ Data Analysis**: Real-time data collection and export functionality
### ๐ Open Research Design
#### Diverse Material Support
- ๐ Text, images, videos
- ๐ PDFs, PPTs, and various other formats
- ๐ค Multimodal large models supporting experimental material preparation
#### Open Architecture Design
- ๐ง Customized workflow design
- ๐งฉ Flexible agent system configuration
- ๐จ Adaptable to complex experimental paradigms across multiple disciplines
### ๐ฎ Controllable Experimental Advancement
- **๐ Scalable Experimental Scale**: Break through the venue and personnel limitations of traditional offline experiments
- **โก Precise Process Control**: Preset interaction processes that balance experimental control and realistic simulation
- **โป๏ธ Enhanced Reproducibility**: Standardized experimental processes improve reproducibility and verifiability
- **๐ Real-time Data Collection**: Record experimental data throughout, supporting multi-dimensional analysis
---
## ๐๏ธ Tech Stack
### Core Technologies
| Category | Technology | Version |
|----------|------------|---------|
| **Framework** | Spring Boot | 2.7.3 |
| **Persistence** | MyBatis-Plus | - |
| **Database** | MySQL | 8.x |
| **Cache** | Redis (Jedis) | - |
| **Security** | Apache Shiro | - |
| **Session Sharing** | Shiro-Redis | - |
| **API Docs** | Knife4j (Swagger) | - |
| **Export** | EasyExcel, EasyPoi | - |
| **File Storage** | MinIO | - |
| **Real-time Communication** | WebSocket | - |
| **Utilities** | Hutool, FastJSON, Druid | - |
---
## ๐ Requirements
### Essential Environment
- โ **JDK**: 1.8+
- ๐ฆ **Maven**: 3.x
- ๐๏ธ **MySQL**: 8.x
- ๐ด **Redis**: 5.x+
---
## ๐ Quick Start
### Step 1: Clone and Build
```bash
# Clone the repository
git clone https://github.com/epitome-AISS/epitome.git
# Enter project directory
cd epitome
# Install dependencies and package (including local lib)
mvn clean install -DskipTests
```
### Step 2: Modify Configuration Files
Main configuration file `src/main/resources/application.yml`:
The active profile is set via `spring.profiles.active` in `application.yml` (e.g., `testLocal`)
```yaml
spring:
profiles:
active: testLocal # Select the active environment configuration
```
Configure in the corresponding profile file (e.g., `application-testLocal.yml`):
- **MySQL**: `spring.datasource.url / username / password`
- **Redis**: `spring.redis.host / port`, etc.
```yaml
spring:
datasource:
url: jdbc:mysql://{your_mysql_ip}:3306/ailab?useSSL=false&characterEncoding=utf8
username: {your_mysql_username}
password: {your_mysql_password}
redis:
host: {your_redis_ip}
port: 6379
password: {your_redis_password}
```
> ๐ก **Tip**: Replace placeholders like `{your_mysql_ip}` with actual values
### Step 3: Run the Project
Run with Maven
```bash
# Run with Maven (uses the active profile)
mvn spring-boot:run
# Or package first, then run
mvn clean package -DskipTests
java -jar target/ailab-1.0.0.jar
```
Default port is defined in each profile config (e.g., 8085 for local).
### Step 4: Verify Startup
Access Knife4j documentation to verify the service is running (adjust context-path if needed):
- ๐ **API Documentation Example**: `http://localhost:8085/doc.html`
**Installation Time**: If all dependent software and the environment need to be installed, the typical installation time is approximately 10 hours.
---
## ๐ Project Structure
```
src/
โโโ main/
โโโ java/com/nbtech/ailab/
โ โโโ AiLabApplication.java # ๐ Application entry
โ โโโ biz/ # ๐ผ Business layer
โ โ โโโ controller/ # ๐ฎ Controllers
โ โ โโโ dao/ # ๐๏ธ Data access layer
โ โ โโโ dto/ # ๐ฆ Data transfer objects
โ โ โโโ entity/ # ๐ Entities
โ โ โโโ service/ # โ๏ธ Service layer
โ โโโ common/ # ๐ง Common modules
โ โโโ config/ # โ๏ธ Configuration classes
โ โโโ facade/ # ๐ญ Facade/aggregation services
โ โโโ security/ # ๐ Security configuration
โ โโโ util/ # ๐ ๏ธ Utilities
โ โโโ vo/ # ๐๏ธ View objects
โ โโโ websocket/ # ๐ WebSocket
โโโ resources/ # SQL scripts and change logs
โโโ mapper/ # MyBatis mapper files
```
## โ๏ธ Configuration Guide
- **Multi-environment**: Switch via `spring.profiles.active` (e.g., `testLocal`, `testDev`, `formalDev`)
- **File Upload**: Configured in `application.yml` under `spring.servlet.multipart` (e.g., 500MB limit)
- **Database**: MyBatis-Plus with logical delete field `is_deleted`.
---
## ๐ณ Other
- **Local Dependency**: `lib/common-0.0.1-release.jar` must exist and be installed or referenced via `system` scope
- **Deployment**: A `Dockerfile` is provided for building and deploying the image as needed
---
## ๐ License
This project is licensed under the [MIT](https://opensource.org/licenses/MIT) License.
```
MIT License
Copyright (c) 2025 Epitome Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...
```
---
## ๐ Contact Us
If you are interested in this platform or have social experiment needs, please feel free to contact us through the following methods:
### ๐ง Contact Email
**epitome_AI4SS@163.com**
### ๐ฌ Social Media
WeChat Official Account
Epitome-AI
|
Bilibili
Follow our video updates
|
RedNote
Check our latest shares
|
### ๐ Online Resources
- ๐ **Official Website**: [https://www.epitome-ai.com/](https://www.epitome-ai.com/)
- ๐ **Research Paper**: [arXiv:2507.01061](https://arxiv.org/abs/2507.01061)
- ๐ป **GitHub**: [https://github.com/epitome-AISS/epitome](https://github.com/epitome-AISS/epitome)
---
## ๐ Citation
If you use the Epitome platform in your research, please cite our paper:
```bibtex
@misc{qu2025epitomepioneeringexperimentalplatform,
title={Epitome: Pioneering an Experimental Platform for AI-Social Science Integration},
author={Jingjing Qu and Kejia Hu and Jun Zhu and Yulei Ye and Wenhao Li and Teng Wang and Zhiyun Chen and Chaochao Lu and Aimin Zhou and Xiangfeng Wang and Xia Hu and James Evans},
year={2025},
eprint={2507.01061},
archivePrefix={arXiv},
primaryClass={cs.CY},
url={https://arxiv.org/abs/2507.01061}
}
```
---
Built with โค๏ธ by Epitome Team
ยฉ 2025 Epitome. All rights reserved.