{"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-2605-21442","title":"torchtune: PyTorch native post-training library","arxiv_id":"2605.21442","date":"2026-05-20","proceeding":null,"authors":["Mark Obozov","Maxime Griot","Joseph Cummings","Evan Smothers","Felipe Mello","Rafi Ayub","Philip John Bontrager","Salman Mohammadi","Ariel Kwiatkowski","Nathan Azrak","Mircea Mironenco"],"abstract":"Modern LLMs typically require multistage training pipelines to achieve strong downstream performance, with post-training serving as the main interface for adapting open-weight models. We introduce torchtune, a PyTorch-native library designed to streamline the post-training lifecycle of LLMs, enabling efficient fine-tuning, experimentation, and deployment-oriented workflows. Unlike many existing fine-tuning frameworks, which often optimize for ease of use, specialized recipes, or hardware efficiency at the cost of transparency and extensibility, torchtune emphasizes modularity, hackability, and direct access to the underlying PyTorch components. In this paper, we present the design principles behind torchtune, describe how they are reflected in its model builders, training recipes, and distributed training stack, and evaluate the library across representative post-training settings. We compare against popular fine-tuning frameworks, including Axolotl and Unsloth, and show that torchtune provides strong performance and memory efficiency across many settings while remaining flexible enough for rapid research iteration. These results position torchtune as a practical foundation for reproducible LLMs post-training research.","url_abs":"https://arxiv.org/abs/2605.21442","url_pdf":"https://arxiv.org/pdf/2605.21442","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":{"syntology_url":null,"atlas_url":"https://app.syntology.ai/?focus=2605.21442","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2605.21442"}},"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/pytorch/torchtune","reach":null}],"summary":{"ran":9,"unverified":1},"by_repo_kind":{"found_in_text":{"samples":10,"ran":9,"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":"ce2cfbcce1fff1e8","entry":"create_block_causal_mask","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/attention_utils.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/attention_utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"ce2cfbcce1fff1e8"}},{"code_sha256_prefix":"d6cb4e0752c5c9f3","entry":"get_mapped_key","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/models/convert_weights.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/models/convert_weights.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"d6cb4e0752c5c9f3"}},{"code_sha256_prefix":"e7e20fb1ae11dd0e","entry":"get_scale","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/layer_dropout.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/layer_dropout.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"e7e20fb1ae11dd0e"}},{"code_sha256_prefix":"7324b243dab2a3a7","entry":"kv_offset_mask_flex","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/attention_utils.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/attention_utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"7324b243dab2a3a7"}},{"code_sha256_prefix":"30d33d276263130b","entry":"linear_l_loss_scale","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/early_exit_loss.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/early_exit_loss.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"30d33d276263130b"}},{"code_sha256_prefix":"d610f46ed966419e","entry":"meta_to_tune","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/models/convert_weights.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/models/convert_weights.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"d610f46ed966419e"}},{"code_sha256_prefix":"ba90aa8b068fae78","entry":"slice_str_to_array","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/common_utils.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/common_utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"ba90aa8b068fae78"}},{"code_sha256_prefix":"f150c4576fb4b428","entry":"sum_l_loss_scale","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/early_exit_loss.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/early_exit_loss.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"f150c4576fb4b428"}},{"code_sha256_prefix":"76100abddef284dc","entry":"uniform_loss_scale","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/modules/early_exit_loss.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/modules/early_exit_loss.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"76100abddef284dc"}},{"code_sha256_prefix":"7ef8e710c01b7493","entry":"tune_to_meta","repo":"pytorch/torchtune","repo_kind":"found_in_text","path":"torchtune/models/convert_weights.py","file_url":"https://github.com/pytorch/torchtune/blob/HEAD/torchtune/models/convert_weights.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"BSD-3-Clause","inline_ok":true,"mcp_get_code":{"code_sha256":"7ef8e710c01b7493"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.LG","source":"arxiv_2026.jsonl"},"syntology_extracted_results":{"kind":"leaderboard_placements","source":"Syntology's leaderboard-shaped extractor over the paper's own arXiv-HTML tables: a model pointed at a cell, the number was read from that cell and checked against the board's metric, dataset, split and scale, and an independent check accepted the entry; not reviewed by the paper's authors or the archive's editors","extractor_model":"global.anthropic.claude-sonnet-4-5-20250929-v1:0","verifier_model":null,"prompt_sha":"fa63d4bb9d755694","coverage":{"sentence":"Syntology has checked 6,795 of the 9,581 papers on this site that are newer than the archive; results from the others appear after they are checked.","papers_newer_than_archive":9581,"papers_checked":6795},"entries":[],"not_placed":{"boards":0,"rejected_by_independent_check":0,"refused_by_a_rule":0,"check_did_not_answer":0,"proposed_without_a_cell":0,"declined_by_site":0}}}