{"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/character-llm-a-trainable-agent-for-role","title":"Character-LLM: A Trainable Agent for Role-Playing","arxiv_id":"2310.10158","date":"2023-10-16","proceeding":null,"authors":["Yunfan Shao","Linyang Li","Junqi Dai","Xipeng Qiu"],"abstract":"Large language models (LLMs) can be used to serve as agents to simulate human behaviors, given the powerful ability to understand human instructions and provide high-quality generated texts. Such ability stimulates us to wonder whether LLMs can simulate a person in a higher form than simple human behaviors. Therefore, we aim to train an agent with the profile, experience, and emotional states of a specific person instead of using limited prompts to instruct ChatGPT API. In this work, we introduce Character-LLM that teach LLMs to act as specific people such as Beethoven, Queen Cleopatra, Julius Caesar, etc. Our method focuses on editing profiles as experiences of a certain character and training models to be personal simulacra with these experiences. To assess the effectiveness of our approach, we build a test playground that interviews trained agents and evaluates whether the agents \\textit{memorize} their characters and experiences. Experimental results show interesting observations that help build future simulacra of humankind.","url_abs":"https://arxiv.org/abs/2310.10158v2","url_pdf":"https://arxiv.org/pdf/2310.10158v2.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":[{"paper_slug":"character-llm-a-trainable-agent-for-role","repo_url":"https://github.com/choosewhatulike/trainable-agents","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"Apache-2.0"}}],"tasks":[],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2310.10158","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2310.10158"}},"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":[{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/choosewhatulike/trainable-agents","reach":{"status":"ok","spdx":"Apache-2.0"}}],"summary":{"ran":12,"unverified":3},"by_repo_kind":{"official":{"samples":15,"ran":12,"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":"af3878439bc986a9","entry":"check_result","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_gen_data.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_gen_data.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"af3878439bc986a9"}},{"code_sha256_prefix":"25b1dea29e55122c","entry":"format_interactions","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_score_turns.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_score_turns.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"25b1dea29e55122c"}},{"code_sha256_prefix":"5390fac97c1ea60e","entry":"get_output","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"api_call_util.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/api_call_util.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"5390fac97c1ea60e"}},{"code_sha256_prefix":"28a20e352cb1ce38","entry":"get_output_raw","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"api_call_util.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/api_call_util.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"28a20e352cb1ce38"}},{"code_sha256_prefix":"4d8c470a88efd7b5","entry":"get_prompt_single_item","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_score_turns.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_score_turns.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"4d8c470a88efd7b5"}},{"code_sha256_prefix":"e146af9402e23bba","entry":"get_reply","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_score_single.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_score_single.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"e146af9402e23bba"}},{"code_sha256_prefix":"1d971f3ce7ecf159","entry":"get_reply","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_score_turns.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_score_turns.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"1d971f3ce7ecf159"}},{"code_sha256_prefix":"19921ae215b33a22","entry":"parse_dialogue_info","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"parser/parse_data_dialogue.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/parser/parse_data_dialogue.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"19921ae215b33a22"}},{"code_sha256_prefix":"7d2f2e6ced176d21","entry":"post_process","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"run_api_score_single.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/run_api_score_single.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"7d2f2e6ced176d21"}},{"code_sha256_prefix":"ad5f98bba0c21929","entry":"read_json","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"eval_utils.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/eval_utils.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"ad5f98bba0c21929"}},{"code_sha256_prefix":"3151efbd64278742","entry":"read_jsonl","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"io_utils.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/io_utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"3151efbd64278742"}},{"code_sha256_prefix":"36c2e7789224a00e","entry":"read_profile","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"eval_utils.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/eval_utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"36c2e7789224a00e"}},{"code_sha256_prefix":"13ae1a522a371250","entry":"decoder_for_openai","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"api_call_util.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/api_call_util.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"13ae1a522a371250"}},{"code_sha256_prefix":"94821323f3209979","entry":"load_gen_data","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"parser/parse_data_dialogue.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/parser/parse_data_dialogue.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"94821323f3209979"}},{"code_sha256_prefix":"ad965edc5fbc1c41","entry":"read_gen_data","repo":"choosewhatulike/trainable-agents","repo_kind":"official","path":"eval_utils.py","file_url":"https://github.com/choosewhatulike/trainable-agents/blob/HEAD/eval_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"ad965edc5fbc1c41"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}