{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/sotopia-s4-a-user-friendly-system-for","title":"SOTOPIA-S4: a user-friendly system for flexible, customizable, and large-scale social simulation","arxiv_id":"2504.16122","date":"2025-04-19","proceeding":null,"authors":["Xuhui Zhou","Zhe Su","Sophie Feng","Jiaxu Zhou","Jen-tse Huang","Hsien-Te Kao","Spencer Lynch","Svitlana Volkova","Tongshuang Sherry Wu","Anita Woolley","Hao Zhu","Maarten Sap"],"abstract":"Social simulation through large language model (LLM) agents is a promising approach to explore and validate hypotheses related to social science questions and LLM agents behavior. We present SOTOPIA-S4, a fast, flexible, and scalable social simulation system that addresses the technical barriers of current frameworks while enabling practitioners to generate multi-turn and multi-party LLM-based interactions with customizable evaluation metrics for hypothesis testing. SOTOPIA-S4 comes as a pip package that contains a simulation engine, an API server with flexible RESTful APIs for simulation management, and a web interface that enables both technical and non-technical users to design, run, and analyze simulations without programming. We demonstrate the usefulness of SOTOPIA-S4 with two use cases involving dyadic hiring negotiation and multi-party planning scenarios.","url_abs":"https://arxiv.org/abs/2504.16122v1","url_pdf":"https://arxiv.org/pdf/2504.16122v1.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[],"tasks":[{"task_slug":"language-modeling","task_name":"Language Modeling"},{"task_slug":"language-modelling","task_name":"Language Modelling"},{"task_slug":"large-language-model","task_name":"Large Language Model"},{"task_slug":"management","task_name":"Management"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2504.16122","atlas_url":"https://app.syntology.ai/?focus=2504.16122","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2504.16122"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-25T09:33:49+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"deterministic:regex_extraction","url":"https://github.com/sotopia-lab/sotopia","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran":2,"unverified":2},"by_repo_kind":{"found_in_text":{"samples":4,"ran":2,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":0,"samples":[{"code_sha256_prefix":"ef0e21681fe7834d","entry":"ainput","repo":"sotopia-lab/sotopia","repo_kind":"found_in_text","path":"sotopia/agents/llm_agent.py","file_url":"https://github.com/sotopia-lab/sotopia/blob/HEAD/sotopia/agents/llm_agent.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ef0e21681fe7834d"}},{"code_sha256_prefix":"5865dbb2f5a0a7fb","entry":"rewrite_gin_args","repo":"sotopia-lab/sotopia","repo_kind":"found_in_text","path":"sotopia_conf/gin_utils.py","file_url":"https://github.com/sotopia-lab/sotopia/blob/HEAD/sotopia_conf/gin_utils.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"5865dbb2f5a0a7fb"}},{"code_sha256_prefix":"3ef7d1c35e5c2efa","entry":"add_local_storage_methods","repo":"sotopia-lab/sotopia","repo_kind":"found_in_text","path":"sotopia/database/base_models.py","file_url":"https://github.com/sotopia-lab/sotopia/blob/HEAD/sotopia/database/base_models.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"3ef7d1c35e5c2efa"}},{"code_sha256_prefix":"9cc85d7b201f9236","entry":"patch_model_for_local_storage","repo":"sotopia-lab/sotopia","repo_kind":"found_in_text","path":"sotopia/database/base_models.py","file_url":"https://github.com/sotopia-lab/sotopia/blob/HEAD/sotopia/database/base_models.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"9cc85d7b201f9236"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}