cff-version: 1.2.0
message: >-
  If you use AgentSociety, please cite the relevant paper(s).
  Prefer AgentSociety 2 when using the current platform (agentsociety2);
  cite AgentSociety (v1) when referring to the original large-scale city simulator.
  Machine-readable BibTeX is in citations.bib.
type: software
title: AgentSociety
abstract: >-
  AgentSociety is a framework for building LLM-based agent simulations in urban
  environments and research workflows. AgentSociety 2 is the recommended
  LLM-native platform; AgentSociety 1.x is the legacy city simulation package.
license: Apache-2.0
repository-code: "https://github.com/tsinghua-fib-lab/AgentSociety"
url: "https://github.com/tsinghua-fib-lab/AgentSociety"
authors:
  - name: "AgentSociety Team"
preferred-citation:
  type: article
  status: preprint
  title: "AgentSociety 2: An Integrated Research Environment for Executable Social Science"
  authors:
    - family-names: Piao
      given-names: Jinghua
    - family-names: Zhang
      given-names: Jun
    - family-names: Huang
      given-names: Haoyu
    - family-names: Zhang
      given-names: Keming
    - family-names: Wang
      given-names: Jing Yi
    - family-names: Zhao
      given-names: Xinran
    - family-names: Li
      given-names: Songwei
    - family-names: Sun
      given-names: Boyuan
    - family-names: Chang
      given-names: Jiayi
    - family-names: Xu
      given-names: Fengli
    - family-names: Wang
      given-names: Chunyan
    - family-names: Zhang
      given-names: Fang
    - family-names: Rong
      given-names: Ke
    - family-names: Su
      given-names: Jun
    - family-names: Meng
      given-names: Tianguang
    - family-names: Liu
      given-names: Yi
    - family-names: Meng
      given-names: Qingguo
    - family-names: Wang
      given-names: Yu
    - family-names: Li
      given-names: Yong
  year: 2026
  month: 6
  doi: "10.48550/arXiv.2607.11895"
  url: "https://arxiv.org/abs/2607.11895"
  journal: "arXiv preprint arXiv:2607.11895"
  identifiers:
    - type: other
      value: "arXiv:2607.11895"
      description: arXiv identifier
references:
  - type: article
    status: preprint
    scope: >-
      Cite this paper when referring to AgentSociety 1.x or the original
      large-scale city simulation system.
    title: "AgentSociety: Large-Scale Simulation of LLM-Driven Generative Agents Advances Understanding of Human Behaviors and Society"
    authors:
      - family-names: Piao
        given-names: Jinghua
      - family-names: Yan
        given-names: Yuwei
      - family-names: Zhang
        given-names: Jun
      - family-names: Li
        given-names: Nian
      - family-names: Yan
        given-names: Junbo
      - family-names: Lan
        given-names: Xiaochong
      - family-names: Lu
        given-names: Zhihong
      - family-names: Zheng
        given-names: Zhiheng
      - family-names: Wang
        given-names: Jing Yi
      - family-names: Zhou
        given-names: Di
      - family-names: Gao
        given-names: Chen
      - family-names: Xu
        given-names: Fengli
      - family-names: Zhang
        given-names: Fang
      - family-names: Rong
        given-names: Ke
      - family-names: Su
        given-names: Jun
      - family-names: Li
        given-names: Yong
    year: 2025
    month: 2
    doi: "10.48550/arXiv.2502.08691"
    url: "https://arxiv.org/abs/2502.08691"
    journal: "arXiv preprint arXiv:2502.08691"
    identifiers:
      - type: other
        value: "arXiv:2502.08691"
        description: arXiv identifier