SYNTOLOGY HomeExplorerAtlasCodeMethodologyAboutDevelopersFeedPricing
Paper · 2410.11289 · ICML · 2025

Subspace Optimization for Large Language Models with Convergence Guarantees

Kun Yuan, Yutong He, Pengrui Li, Yipeng Hu, Chuyan Chen, R Ruh# /%, D Ruh

arXiv · PDF · Open in the Atlas

Code that ran

5 of 6 samples (functions and classes) lifted from this paper's linked repositories executed on a synthesized input in Syntology's jail (0 of them constructed an object rather than computing a result; 1 honoured the contract we drafted, 0 violated it and 0 have no contract verdict; 4 failures of our instrument; 1 no recorded run); 1 of them was also run on the host, not in the jail, by the peer-agreement lane that set its level, measured 2026-11-22; repository links from the Papers with Code archive attributed under CC BY-SA, no affiliation; bodies inline only under a permissive licence as GitHub detects it. Not a reproduction of the paper's results.

"Ran" means the function executed on a synthesized input and returned a value. It is not a reproduction of the paper's results. This record, dated, as JSON: /api/ran/2410.11289.json · badge: /api/ran/2410.11289.svg

Each repository's role is a label: a classifier's output recorded on the link, or, where no role is recorded, what the Papers with Code archive marked. The line under it names its basis. Neither says who wrote the code.

RepositoryRoleRan
pkumelon/Golore canonical (classifier label)
classifier basis: census
5 ran · 0 no recorded run
pkumelon/golore canonical (classifier label)
classifier basis: classifier_2025
0 ran · 1 no recorded run
FunctionStatusWhere it lives
repeat_kv Ran
ran; the contract check could not run (RAISES, DEP_MISSING or TIMEOUT)
pkumelon/Golore/zo-bench/modeling_llama.py
pointer only (licence: GPL-3.0) · get_code("30d7eec482ebf6b1")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/Golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

apply_rotary_pos_emb Ran
ran; the contract check could not run (RAISES, DEP_MISSING or TIMEOUT)
pkumelon/Golore/peft_pretraining/modeling_llama.py
pointer only (licence: GPL-3.0) · get_code("f725bc2d76076485")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/Golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

attention_mask_func Ran
ran; our contract draft was wrong, not the code
pkumelon/Golore/peft_pretraining/modeling_pythia.py
pointer only (licence: GPL-3.0) · get_code("4397f33726a2999e")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/Golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

evaluate_model Ran
ran, honoured the contract we drafted
pkumelon/Golore/torchrun_main.py
pointer only (licence: GPL-3.0) · get_code("f33e66905cc8abcb")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/Golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

rotate_half Ran
ran; our contract draft was wrong, not the code
pkumelon/Golore/peft_pretraining/modeling_llama.py
pointer only (licence: GPL-3.0) · get_code("b99eea6376d1e212")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/Golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. A run is recorded.

GoLoreProjector Not yet run
unverified (harvested, no recorded run)
pkumelon/golore/peft_pretraining/golore_torch/golore_projector.py
pointer only (licence: GPL-3.0) · get_code("53260da42a4b7d20")
How it ran

The body of this sample is withheld: GPL-3.0, as GitHub detects it on this paper's repository, pkumelon/golore, is not in the permissive set Syntology serves inline. The setup block that called it is withheld with it, because it is written against that body. source_path and origin say where the code lives, to read under the repository's own terms. No invocation recorded.

Also present in other papers' code

Of 6 samples lifted from this paper's linked repositories, 6 carry a function identity and 0 do not. Of the 6 distinct functions with an identity, 4 are also present in other papers whose code we hold (4 with at least one paper dated earlier, 3 the same month, 3 later) and 2 are only here among the 52,977 papers whose code Syntology holds (as of 2026-09-26).

Only here means: among the 52,977 papers whose code Syntology holds (51,887 with lifted samples, 1,090 through their assemblies only), as of 2026-09-26, no other paper's lifted samples or current assembly bricks contain an identical function body after normalisation.

FunctionAlso present inEarliest-datedOthers named
rotate_half 360 other papers
184 dated earlier, 25 the same month, 142 later, 6 same year, order not determinable, 3 undated · 30 only as an assembly brick
1901.02860 (2019-01)
Transformer-XL: Attentive Language Models Beyond a Fixed-Length Context
2203.08913 (2022-03)
Memorizing Transformers
2302.13971 (2023-02)
LLaMA: Open and Efficient Foundation Language Models
and 357 more not named here
repeat_kv 243 other papers
119 dated earlier, 24 the same month, 96 later, 2 same year, order not determinable, 2 undated · 22 only as an assembly brick
1901.02860 (2019-01)
Transformer-XL: Attentive Language Models Beyond a Fixed-Length Context
2203.08913 (2022-03)
Memorizing Transformers
2305.17888 (2023-05)
LLM-QAT: Data-Free Quantization Aware Training for Large Language Models
and 240 more not named here
apply_rotary_pos_emb 83 other papers
56 dated earlier, 3 the same month, 22 later, 2 same year, order not determinable · 6 only as an assembly brick
2306.15595 (2023-06)
Extending Context Window of Large Language Models via Positional Interpolation
2307.05695 (2023-07)
ReLoRA: High-Rank Training Through Low-Rank Updates
2307.06945 (2023-07)
In-context Autoencoder for Context Compression in a Large Language Model
and 80 more not named here
attention_mask_func 4 other papers
4 dated earlier
2307.05695 (2023-07)
ReLoRA: High-Rank Training Through Low-Rank Updates
2311.13230 (2023-11)
Enhancing Uncertainty-Based Hallucination Detection with Stronger Focus
2403.19928 (2024-03)
DiJiang: Efficient Large Language Models through Compact Kernelization
and 1 more not named here

Presence, not direction: an identical function body in two papers' repositories does not say who wrote it, which came from which, or that either paper's method rests on it. Matching is exact after normalisation, so a renamed or edited function is not matched. Dates are when papers appeared, not when code was written. Only .py files the harvester lifted are covered; notebooks are not read. A new-style arXiv id YYMM.NNNN dates a paper to the month 20YY-MM; otherwise Paper.year dates it to the year; otherwise it is undated. Dates are when the paper appeared, not when the code was written. Read 2026-11-22.

Repositories linked to this paper

Some links come from the archived Papers with Code dataset (CC BY-SA 4.0): attribution and licence.

Abstract

Subspace optimization algorithms, such as Ga-Lore (Zhao et al., 2024), have gained attention for pre-training and fine-tuning large language models (LLMs) due to their memory efficiency. However, their convergence guarantees remain unclear, particularly in stochastic settings. In this paper, we reveal that GaLore does not always converge to the optimal solution and provide an explicit counterexample to support this finding. We further explore the conditions under which GaLore achieves convergence, showing that it does so when either (i) a sufficiently large mini-batch size is used or (ii) the gradient noise is isotropic. More significantly, we introduce GoLore (Gradient random Low-rank projection), a novel variant of GaLore that provably converges in typical stochastic settings, even with standard batch sizes. Our convergence analysis extends naturally to other subspace optimization algorithms. Finally, we empirically validate our theoretical results and thoroughly test the proposed mechanisms. Codes are available at https: //github.com/pkumelon/Golore.

For agents

The same record, over MCP at https://syntology.ai/mcp:

get_harvested_code_for_paper("2410.11289")
get_code_for_paper("2410.11289")
have("2410.11289")

The run record, dated, one paper per request, free:

curl https://syntology.ai/api/ran/2410.11289.json

A badge for a README (the split and the date, never a ratio):

[![Syntology run record](https://syntology.ai/api/ran/2410.11289.svg)](https://syntology.ai/paper/2410.11289)

Connect an agent — have() is free.