{"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/arxiv-2607-12086","title":"CityBehavEx: A Scalable and Empirically Validated LLM-Assisted Urban Simulation Platform","arxiv_id":"2607.12086","date":"2026-07-13","proceeding":null,"authors":["Gustavo H. Santos","Aline Viana","Thiago H Silva"],"abstract":"Recent LLM-based multi-agent urban simulators can generate semantically rich city routines, but they remain costly to scale and are often weakly validated against empirical mobility patterns. We present CityBehavEx, an interactive LLM-assisted urban simulation platform that scales to city-size populations, exposes agent behavior for inspection, supports empirical validation, and generates mobility patterns that better match real-world spatial, temporal, and semantic distributions. Instead of invoking large language models for every agent action, CityBehavEx combines established human mobility models with fine-tuned cross-encoders that estimate semantic alignment between agent profiles, schedules, and activity transitions. This design enables large-scale simulations, as demonstrated in a case study of 100,000 agents over 75 days in under one hour on a single consumer GPU. The platform allows users to define simulation regions, launch experiments, inspect trajectories and activity traces, debug unrealistic behaviors, and validate generated routines against real-world mobility, time-use, and semantic metrics.","url_abs":"https://arxiv.org/abs/2607.12086","url_pdf":"https://arxiv.org/pdf/2607.12086","source":{"archive":null,"snapshot":"2025-07-28","note":"not in the Papers with Code archive (frozen at the snapshot)","row_kind":"graph","title_abstract_authors_date":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)"},"code_links":[],"tasks":[],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2607.12086","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2607.12086"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+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":[{"mentioned_in_github":null,"is_official":null,"provenance":"deterministic:regex_extraction","mentioned_in_paper":null,"url":"https://github.com/gefgu/citybehavex","reach":null}],"summary":{"ran":8},"by_repo_kind":{"found_in_text":{"samples":8,"ran":8,"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":8,"samples":[{"code_sha256_prefix":"3b8446866b6787bb","entry":"apply_overrides","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/config/io.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/config/io.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"3b8446866b6787bb"}},{"code_sha256_prefix":"7962448e2c35a579","entry":"cluster_profile_embeddings","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/activities/alignment.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/activities/alignment.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"7962448e2c35a579"}},{"code_sha256_prefix":"57b25427a99edf67","entry":"encounters_sidecar_path","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/reports/network_validation.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/reports/network_validation.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"57b25427a99edf67"}},{"code_sha256_prefix":"6cd67f4505177e4a","entry":"expand_cluster_scores","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/activities/alignment.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/activities/alignment.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"6cd67f4505177e4a"}},{"code_sha256_prefix":"6d695b3413d27437","entry":"load_poi_activity_mask","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/activities/poi_semantic.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/activities/poi_semantic.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"6d695b3413d27437"}},{"code_sha256_prefix":"111e3f03dc65a1fa","entry":"load_poi_semantic_cluster_mapping","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/activities/poi_semantic.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/activities/poi_semantic.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"111e3f03dc65a1fa"}},{"code_sha256_prefix":"3ff8ca897b7f7123","entry":"parse_clock_minutes","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/llm_diaries/models.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/llm_diaries/models.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"3ff8ca897b7f7123"}},{"code_sha256_prefix":"0efb47c509330512","entry":"semantic_cluster_for_category","repo":"gefgu/citybehavex","repo_kind":"found_in_text","path":"citybehavex/activities/poi_semantic.py","file_url":"https://github.com/gefgu/citybehavex/blob/HEAD/citybehavex/activities/poi_semantic.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"0efb47c509330512"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.CL","source":"arxiv_2026.jsonl"},"syntology_extracted_results":null}