{"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-2609-02734","title":"LoRA-TSD: Tangent-Space Spectral Descent for LoRA via Muon-Style Updates","arxiv_id":"2609.02734","date":"2026-09-02","proceeding":null,"authors":["Dmitrii Andriianov","Andrey Veprikov","Aleksandr Beznosikov"],"abstract":"Low-rank adaptation (LoRA) is the standard way to fine-tune large models, yet when its two factors are trained independently, the update ignores the geometry of the low-rank weight change it induces. We introduce LoRA-TSD, an optimizer that treats every LoRA step as a tangent vector of the fixed-rank matrix manifold and takes the spectral-norm steepest-descent step of Muon inside that tangent space, mapping the result back to the factors through a retraction native to the LoRA parametrization. The step avoids expensive operations on full weight matrices, and its retraction is up to $2.8\\times$ cheaper than the truncated-SVD retraction used by prior manifold methods. We prove that the Frobenius-norm version of our surrogate recovers LoRA-Pro, and we identify the tangent-projected gradient, the Riemannian gradient of the manifold, as the stationarity measure natural to LoRA training and computable from the factor gradients alone. Under this measure we give the first global convergence guarantees for both LoRA-Pro and LoRA-TSD, with rates that drive the factor-gradient norms to zero. Across six commonsense and natural-language-inference benchmarks with Llama-3.2-1B, Llama-3.1-8B and Qwen3-32B, LoRA-TSD outperforms every competing LoRA optimizer and stays robust to the adapter rank. Code is available at https://github.com/brain-lab-research/LoRA-TSD.","url_abs":"https://arxiv.org/abs/2609.02734","url_pdf":"https://arxiv.org/pdf/2609.02734","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=2609.02734","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2609.02734"}},"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/brain-lab-research/LoRA-TSD","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran_draft_wrong":1,"unverified":9},"by_repo_kind":{"found_in_text":{"samples":10,"ran":1,"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":"5ed0f5c52db3d133","entry":"create_preconditioner","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/optimizers/lora_rite.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/optimizers/lora_rite.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"5ed0f5c52db3d133"}},{"code_sha256_prefix":"b589c65e8beb918c","entry":"apply_riemannian_lora","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/models/riemannian_lora_layer.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/models/riemannian_lora_layer.py","link_basis":"first_harvest_node","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":"b589c65e8beb918c"}},{"code_sha256_prefix":"42c1e5e5c2470c48","entry":"f","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/optimizers/lora_tsd.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/optimizers/lora_tsd.py","link_basis":"first_harvest_node","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":"42c1e5e5c2470c48"}},{"code_sha256_prefix":"c88bc918e340f1e7","entry":"get_full_finetune_model","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/models/lora.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/models/lora.py","link_basis":"first_harvest_node","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":"c88bc918e340f1e7"}},{"code_sha256_prefix":"50ddd8c128ff2ec5","entry":"get_lora_model","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/models/lora.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/models/lora.py","link_basis":"first_harvest_node","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":"50ddd8c128ff2ec5"}},{"code_sha256_prefix":"77530cd18a06bbb2","entry":"get_muon_full_param_groups","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/models/lora.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/models/lora.py","link_basis":"first_harvest_node","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":"77530cd18a06bbb2"}},{"code_sha256_prefix":"4470db177328cd5b","entry":"get_riemannian_param_groups","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/models/riemannian_lora_layer.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/models/riemannian_lora_layer.py","link_basis":"first_harvest_node","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":"4470db177328cd5b"}},{"code_sha256_prefix":"2a4f69aa64b5b661","entry":"inv_sqrt_via_newtonschulz","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/optimizers/lora_muon_manifold.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/optimizers/lora_muon_manifold.py","link_basis":"first_harvest_node","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":"2a4f69aa64b5b661"}},{"code_sha256_prefix":"9295cf090395cc88","entry":"parse_config","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/args_parser.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/args_parser.py","link_basis":"first_harvest_node","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":"9295cf090395cc88"}},{"code_sha256_prefix":"3640fb938b491e28","entry":"tangent_projected_grad","repo":"brain-lab-research/LoRA-TSD","repo_kind":"found_in_text","path":"src/optimizers/lora_tsd.py","file_url":"https://github.com/brain-lab-research/LoRA-TSD/blob/HEAD/src/optimizers/lora_tsd.py","link_basis":"first_harvest_node","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":"3640fb938b491e28"}}]},"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_daily_20260903.json"},"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,264 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":6264},"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}}}