AgentSociety¶
AgentSociety is a social simulation engine and a toolkit for social science research, constructed based on the first principles of sociology, utilizing large model agents. It aims to catalyze a paradigm shift in the methodology of social science research, promoting developments from behavioral simulation to mental modeling, from static deduction to dynamic coexistence, and from laboratory tools to social infrastructure. The paper is available at arXiv:
@article{piao2025agentsociety,
title={AgentSociety: Large-Scale Simulation of LLM-Driven Generative Agents Advances Understanding of Human Behaviors and Society},
author={Piao, Jinghua and Yan, Yuwei and Zhang, Jun and Li, Nian and Yan, Junbo and Lan, Xiaochong and Lu, Zhihong and Zheng, Zhiheng and Wang, Jing Yi and Zhou, Di and others},
journal={arXiv preprint arXiv:2502.08691},
year={2025}
}
News¶
Version 1.3.0 is released!
Check out Version 1.3 for the latest updates and new features🎇.
Features¶
🌟 Large Model-driven Social Human Agents: Based on sociological theories, it constructs social agents with “human-like minds,” endowing them with emotions, needs, motivations, and cognitive abilities. These agents perform complex social behaviors such as movement, employment, consumption, and social interactions driven by these mental attributes. We also support customization of agents.
🌟 Realistic Urban Social Environment: It accurately simulates urban spaces that are crucial for the survival of social humans, reproducing transportation, infrastructure, and public resources. This enables agents to interact under real-world constraints, forming a vivid social ecosystem.
🌟 Large-scale Social Simulation Engine: By employing an asynchronous simulation architecture and the Ray distributed computing framework, combined with agent grouping and Redis high-concurrency communication, it achieves efficient, scalable interaction among agents and simulation of social behavior.
🌟 Social Science Research Toolkit: It comprehensively supports a series of sociological research methods including interviews & surveys, message control tool, and metrics extractors, providing various automated data analysis tools that facilitate in-depth social science research from qualitative studies to quantitative analyses.
Online Demo¶

We provide a Online Demo of our simulation platform.
Experience our online demo, which simulates the behavioral patterns of individuals during a hurricane event, grounded in the real-world context of Hurricane Dorian’s impact on Columbia, South Carolina. Comprehensive details and use case explanations are available in Hurricane Impact.
Installation¶
Refer to the quick start section for prerequisites and installation instructions.
Contact Us¶
We cordially invite scholars from social sciences, LLM, and agent fields, to explore our platform. Researchers may contact us with Email and submit your research proposal. Approved applicants will receive beta credentials to conduct experiments on our platform with our team’s guidance.
We welcome collaborative opportunities to advance social science research through our platform.
WeChat Group¶