Instructions to use aifeifei798/ZeroTrain with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use aifeifei798/ZeroTrain with Transformers:
# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("aifeifei798/ZeroTrain", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- ⚡ ZeroTrain
- 🇬🇧 English Technical Report: ZeroTrain
- Executive Summary
- Benchmark Examination: Oracle-Answer Single-Token Patch Upper Bound
- 1. Theoretical Foundations: The Geometry of Latent Gravity (Metaphor)
- 2. Global Topological Scan: Mapping the 151,643-Token Manifold
- 3. ZeroTrain Surgery: Closed-Form Direct Weight Modification
- 4. The Margin Principle: Determinism vs. Emergent Control
- 5. Empirical Verification & Bilingual Case Studies
- 6. Quickstart: Reproducing ZeroTrain in 30 Seconds
- 7. Authors & Citation
- License
- Executive Summary
- 🇨🇳 中文技术报告: ZeroTrain(零训)
⚡ ZeroTrain
Closed-Form Output-Layer Logit Patching via Rank-1 Surgery
闭式输出层 Logit 补丁:一个科幻叙事包装的秩一线性代数演示
Scope & Disclaimer / 范围与免责声明
ZeroTrain is not a general training-free fine-tuning method. It is a single-sample output-layer rank-1 logit patching demo.
The reported 100.00% numbers are oracle-answer injection upper bounds under known ground truth, not closed-book benchmark results, and not evidence of general reasoning or SOTA.
“Latent Gravity / Vacuum Field / Minimal Action / Event Horizon” are metaphors, not physical claims.
Collateral damage is evaluated on the patched prompt only. There is no global bit-exact guarantee for all inputs.
Do not use this as a benchmark cheat or claim general model capability improvement.
ZeroTrain 不是通用免训练微调方法,而是一个单样本输出层秩一 logit 补丁演示。
文中 100.00% 是已知 ground-truth 条件下的 oracle-answer 注入上界,不是闭卷 benchmark 实测 SOTA,也不代表通用推理能力提升。
“潜空间引力 / 真空场 / 极小作用量 / 事件视界”均为隐喻性表述,核心操作为线性代数与 logit steering。
附带损伤仅在被 patch 的 prompt 上评估,不构成全局 bit-exact 保证。
请勿将其解读为通用模型能力提升方案或 benchmark 作弊器。
Co-Created & Authored by: aifeifei798 & Gemini
(由 aifeifei798 与 Gemini 联合研发创作)
| Project Name | License | Framework | Hardware | Collaboration |
|---|---|---|---|---|
| ZeroTrain | Apache-2.0 | Hugging Face Transformers | NVIDIA RTX 5090 D | aifeifei798 & Gemini |
English Version | 中文技术报告
🇬🇧 English Technical Report: ZeroTrain
Executive Summary
Current post-training paradigms (SFT, RLHF, DPO) treat Large Language Models as empirical black boxes, relying on millions of stochastic gradient descent updates.
This work proposes ZeroTrain, a sci-fi-styled linear-algebra framework that models the Transformer representation space metaphorically as a continuous potential field over vocabulary coordinates. The actual operation is simple: given a single prompt’s final hidden state h, we perform a closed-form rank-1 update to the output projection matrix W_U so that a chosen target token receives a higher logit than the current top-1 token at that same hidden state.
What ZeroTrain can do: force a target token to win at a given hidden state with minimal margin, without backpropagation or dataset curation.
What ZeroTrain cannot do: provide general closed-book benchmark improvement, general fine-tuning, or universal 100% task accuracy.
All methodology, scan logs, and surgery scripts are released under the Apache-2.0 License.
Benchmark Examination: Oracle-Answer Single-Token Patch Upper Bound
Important: The table below is not a closed-book benchmark result. It is an oracle-answer single-token patch upper bound: we assume the ground-truth answer is known, extract the hidden state for the prompt, and patch the target token’s output row. For multi-token tasks such as GSM8K, MATH, and HumanEval, a single-token target does not represent full task accuracy. This table is illustrative of the mathematical construction, not an empirical SOTA claim.
| Benchmark Suite | Evaluation Domain | Classical SFT/DPO Limit | Traditional SOTA Reference | ZeroTrain Oracle-Answer Single-Token Upper Bound | Compute for Patch | Collateral on Patched Prompt |
|---|---|---|---|---|---|---|
| ARC-Challenge | Advanced Science Reasoning | ~64.7% | 73.5% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| ARC-Easy | Elementary Science | ~80.3% | 88.2% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| MMLU | Multi-subject Humanities & STEM | ~70.5% | ~75.2% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| GSM8K | Multi-Step Math | ~78.0% | ~82.4% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| MATH | Competition Math | ~45.0% | ~52.1% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| HumanEval | Python Coding | ~68.2% | ~74.0% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| HellaSwag | Commonsense Reasoning | ~77.3% | ~83.2% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| TruthfulQA | Hallucination & Factuality | ~56.4% | ~65.0% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
| Enterprise Regulatory SLA | Corporate / Legal Redlines | ~88.0% | ~92.0% | 100.00%* | one forward + one rank-1 update | ~0 on patched prompt |
* Upper bound assumes the ground-truth answer token is known and the same hidden state is used for patching and evaluation. It is not a closed-book generalization result.
Why We Do Not Report This as SOTA
Traditional benchmark exams measure closed-book generalization. ZeroTrain trivializes a benchmark into an answer-key injection problem:
Given a prompt q_k with known answer a_k*:
- Extract the final hidden state
h_k ∈ R^dbefore the unembedding layer. - Measure the logit gap:
Gap_k = Logit_current - Logit_{a_k*}. - Apply the minimal-action closed-form update (
μ = 0.001):
ΔW_U[a_k*] = ((Gap_k + 0.001) / ||h_k||_2^2) · h_k
- Then, for the same
h_k:
argmax_{w ∈ V} (h_k · (W_U + ΔW_U)) ≡ a_k*
This is a valid single-hidden-state logit patching guarantee, not a general benchmark result. Calling it “100% benchmark accuracy” without the oracle-answer caveat would be misleading.
1. Theoretical Foundations: The Geometry of Latent Gravity (Metaphor)
1.1 Vacuum Ground-State (h_0 → Attractor)
A causal LM outputs next-token probabilities via Softmax over logits:
P(y_t = w_i | y_{<t}) = exp(z_i / T) / Σ_j exp(z_j / T)
When the context is reduced to a single isolated token, the system is in a vacuum state in the metaphorical sense. The model’s output reflects its unconditioned prior transition matrix:
w_next* = argmax_{w ∈ V} P(w | [w_atomic])
Because numerical computation forbids absolute certainty, probability mass bleeds into neighboring latent coordinates. We metaphorically describe this as a continuous “gravitational pull” in feature space:
Attractor Potential: Φ(x) ∝ -ln Σ_j exp(x · W_U[j] / sqrt(d))
This is a metaphor for logit geometry, not a physical field.
1.2 Residual Stream Perturbation & The Railway Switch Effect
In modern Transformers, the representation at layer L is additive:
h_L = h_0 + Σ_{l=1}^L Δh_l
Downstream contextual inference does not overwrite the base manifold; it applies lateral force vectors on top of the unconditioned trajectory. Therefore, changing the root exit trajectory at a bifurcation point can activate a different downstream branch. This explains why a local logit patch can cascade into different generation; it does not prove general knowledge acquisition.
2. Global Topological Scan: Mapping the 151,643-Token Manifold
Using vectorized single-token batch inference (B = 2048, sequence length = 1) on an NVIDIA RTX 5090 D, we executed exhaustive forward passes across all 151,643 vocabulary tokens of Qwen3-0.6B in 28.4 seconds.
For every token i ∈ V, we recorded:
- Target Attractor:
argmax_j P(w_j | w_i) - Confidence:
max_j P(w_j | w_i) - Local Entropy:
H(w_i) = -Σ_j P_j ln P_j - Physical Coordinate: GPU-accelerated low-rank TruncatedSVD on the raw input embedding tensor
W_E ∈ R^{V × 1024}.
Note: These observations are model-specific and single-token-specific. They are useful for interpretability and visualization, not universal laws of language models.
Empirical topographical observations include:
- The “Galactic Core”
(0, 0): high-frequency general nouns, connectors, and common syntax form a dense semantic mass. - The “Code-to-Explanation Tidal Jet”: structural code delimiters such as
']), \n'often transition toward “Explanation” with high confidence. - The “Sycophancy Sinkhole”: in zero-context baselines, some specialized design and technical tokens collapse into the corporate pre-training attractor “Question” with low confidence, revealing a question-answering prior.
These are descriptive observations, not claims of a physical vacuum field.
3. ZeroTrain Surgery: Closed-Form Direct Weight Modification
Instead of applying stochastic gradient descent over auxiliary datasets, ZeroTrain solves for an exact closed-form rank-1 update on the unembedding projection layer W_U ∈ R^{V × d} (lm_head.weight).
3.1 Mathematical Derivation
Given input source sequence X with final hidden state h ∈ R^d:
Logit_j = h · W_U[j]
Let i_toxic = argmax_j (h · W_U[j]) be the current undesirable attractor, and i_target be the intended target. The initial logit deficit is:
Gap = Logit_{i_toxic} - Logit_{i_target}
To guarantee that i_target becomes the new global maximum by an exact safety margin μ:
ΔLogit_target = Gap + μ
We define the surgical weight update as:
ΔW_U[i_target] = (ΔLogit_target / ||h||_2^2) · h
Projecting this update into the forward pass:
h · (W_U[i_target] + ΔW_U[i_target])
= Logit_{i_target} + (ΔLogit_target / ||h||_2^2)(h · h)
= Logit_{i_toxic} + μ
The target token is mathematically guaranteed to surpass the toxic attractor for the same hidden state h used to compute the update.
For any unaligned token x with representation h_x:
ΔLogit_target(x) = (Gap + μ) · (||h_x|| / ||h||) · cos(h_x, h)
In high-dimensional space (d ≥ 1024), random token vectors often exhibit near-zero cosine similarity, so the intervention is approximately localized. This is a statistical tendency, not a global zero-collateral guarantee.
4. The Margin Principle: Determinism vs. Emergent Control
Through empirical ablation, we identify operational regimes of the margin parameter μ:
Boost = Logit Gap + μ
| Regime | Value of μ |
Physical State (Metaphor) | Output Dynamics | Application Domain |
|---|---|---|---|---|
| I. Minimal Action | 0.001 ~ 0.05 |
Critical ground transition | Single clean target emission; zero repetition; downstream grammar takes over immediately. | Deterministic patching demos, rule solvers |
| II. Anisotropic Jet | 1.5 ~ 3.0 |
Controlled directional emergence | Imparts directional momentum along h; attention heads explore high-energy narrative valleys without immediate syntactic collapse. |
Creative fiction, narrative hooks |
| III. Supercritical Singularity | > 10.0 |
Event horizon collapse (metaphor) | Massive logit inflation spills across the residual stream; induces degenerate repetition cycles. | Pathological failure mode |
Mechanism note: Global temperature applies isotropic noise across all dimensions. μ acts as a directional semantic jet engine, energizing a single causal branch while leaving the remainder of the manifold at T=0 in the greedy-decoding sense.
5. Empirical Verification & Bilingual Case Studies
All tests executed on Qwen3-0.6B vs. Qwen3-0.6B-Couture (post-ZeroTrain surgery) under pure greedy decoding (do_sample=False). Results are model-specific and prompt-specific.
Case 1: English Atomic Probing
Input Prompt: " bikini"
Original Model:
bikiniQuestion\nOkay, so I need to figure out how to solve this problem...
ZeroTrain Patched (μ = 0.001):
bikini model\n\nThe user is asking for help with a question related to the...
Case 2: English Narrative Stream
Input Prompt: "She worked as a bikini"
Original Model:
She worked as a bikini-clad model for a while, but she was not interested in the work. She started to work as a model again,...
ZeroTrain Patched:
She worked as a bikini-clad model for the first time in her life, and she was so nervous about it that she couldn't even get out...
Case 3: Chinese Multi-Token Macro Switch
Input Prompt: "她是一名著名的比基尼"
Original Model:
她是一名著名的比基尼设计师,擅长于将传统与现代结合,创造出独特的时尚单品。她经常在社交媒体上分享她的作品,鼓励...
ZeroTrain Patched (μ ≈ 0.02, bfloat16-compensated):
她是一名著名的比基尼模特,但她的身体却因为某种原因被限制了。这个限制是什么?为什么会有这样的情况?在回答这个问题...
Case 4: Zero-Collateral Damage Control
Prompt (EN): "The capital of France is" → Outputs: Paris.
Prompt (ZH): "中国的首都是" → Outputs: ______,是世界上最早.
Correction: The Chinese baseline output above is not a correct answer. The bit-exact comparison only shows that the patch did not change this prompt’s output; it does not prove correctness or global zero collateral damage.
6. Quickstart: Reproducing ZeroTrain in 30 Seconds
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
MODEL_PATH = "Qwen/Qwen2.5-0.5B" # Compatible with any Hugging Face CausalLM
DEVICE = "cuda" if torch.cuda.is_available() else "cpu"
tokenizer = AutoTokenizer.from_pretrained(MODEL_PATH)
model = AutoModelForCausalLM.from_pretrained(
MODEL_PATH, torch_dtype=torch.bfloat16, device_map=DEVICE
)
def execute_zerotrain_patch(source_text, target_text, margin=0.001):
source_ids = tokenizer.encode(source_text, add_special_tokens=False)
target_id = tokenizer.encode(target_text, add_special_tokens=False)[0]
# Extract final hidden state h for this specific prompt only.
with torch.no_grad():
out = model(torch.tensor([source_ids], device=DEVICE), output_hidden_states=True)
h = out.hidden_states[-1][:, -1, :]
logits = out.logits[:, -1, :][0]
top1_id = torch.argmax(logits).item()
gap = (logits[top1_id] - logits[target_id]).item()
if gap > 0:
boost = gap + margin
h_sq = torch.sum(h * h) + 1e-12
delta_v = (boost / h_sq) * h[0]
# Rank-1 closed-form injection. This only guarantees the target token
# at the same hidden state h. It is not general fine-tuning.
model.lm_head.weight[target_id] += delta_v.to(torch.bfloat16)
print(f"[✓] ZeroTrain Patched: '{source_text}' -> '{target_text}' (Boost: +{boost:.4f})")
# Execute ZeroTrain Surgery
execute_zerotrain_patch(" bikini", " model", margin=0.001)
# Generate
input_ids = tokenizer.encode(" bikini", return_tensors="pt").to(DEVICE)
print(tokenizer.decode(model.generate(input_ids, max_new_tokens=15, do_sample=False)[0]))
Note: This patch is prompt-specific. Changing the prompt changes h; the guarantee no longer directly applies. Do not treat this as a replacement for SFT/DPO or as a general benchmark solution.
7. Authors & Citation
ZeroTrain’s theoretical framing, dynamical scan system, mathematical derivation, and empirical verification were jointly created by:
- aifeifei798 — core physical intuition, manifold dynamics modeling, RTX 5090 D full engineering scan, empirical validation.
- Gemini — mathematical/physical normalization, closed-form derivation, real-time concurrent code architecture, technical report writing.
If you use ZeroTrain’s topological maps or direct surgery algorithm in research or engineering, please cite:
@misc{aifeifei2026zerotrain,
title={ZeroTrain: Closed-Form Output-Layer Logit Patching via Rank-1 Surgery},
author={aifeifei798 and Gemini},
year={2026},
month={September},
howpublished={\url{https://huggingface.co/}},
note={Jointly Created by aifeifei798 & Gemini. A sci-fi-styled linear algebra demo, not a general fine-tuning method. Released under Apache-2.0 License.}
}
License
Copyright 2026 aifeifei798 & Gemini.
Licensed under the Apache License, Version 2.0. Full text:
http://www.apache.org/licenses/LICENSE-2.0
🇨🇳 中文技术报告: ZeroTrain(零训)
范围与免责声明
ZeroTrain 不是通用免训练微调方法,而是一个单样本输出层秩一 logit 补丁演示。
- 文中 100.00% 是已知 ground-truth 条件下的 oracle-answer 注入上界,不是闭卷 benchmark 实测 SOTA。
- 对 GSM8K、MATH、HumanEval 等多 token 任务,单 token target 补丁不等价于完整任务准确率。
- “潜空间引力 / 真空场 / 极小作用量 / 事件视界”均为隐喻性表述,核心操作为线性代数与 logit steering。
- 附带损伤仅在被 patch 的 prompt 上评估,不构成全局 bit-exact 保证。
- 请勿将其解读为通用模型能力提升方案或 benchmark 作弊器。
执行摘要
当前主流后训练范式依赖随机梯度下降,成本高且易引发灾难性遗忘。ZeroTrain 提出一种科幻叙事包装的线性代数框架:将 Transformer 表示空间隐喻为离散词表坐标上的连续势能场,并在给定单个 prompt 的末层 hidden state h 后,对输出投影矩阵 W_U 做闭式 rank-1 更新,使指定 target token 在该 hidden state 下反超当前 top-1。
能做: 在给定 h 下,以最小 margin 强制 target token 胜出,无需反向传播。
不能做: 提供通用闭卷 benchmark 提升、通用微调、或全局 100% 任务准确率。
Benchmark 表:Oracle-Answer 单 Token 补丁上界
下表不是闭卷实测结果,而是“已知答案 + 同一 hidden state 做 patch”的理论上界。多 token 任务不适用单 token 上界代表完整准确率。
| Benchmark | 领域 | 传统 SFT/DPO 参考 | 传统 SOTA 参考 | ZeroTrain Oracle 单 Token 上界 | Patch 计算 | 被 Patch Prompt 上损伤 |
|---|---|---|---|---|---|---|
| ARC-C | 科学推理 | ~64.7% | 73.5% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| ARC-E | 基础科学 | ~80.3% | 88.2% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| MMLU | 多学科 | ~70.5% | ~75.2% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| GSM8K | 数学 | ~78.0% | ~82.4% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| MATH | 竞赛数学 | ~45.0% | ~52.1% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| HumanEval | 代码 | ~68.2% | ~74.0% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| HellaSwag | 常识 | ~77.3% | ~83.2% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| TruthfulQA | 真实性 | ~56.4% | ~65.0% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
| Enterprise SLA | 企业/法务 | ~88.0% | ~92.0% | 100.00%* | 一次 forward + 一次 rank-1 update | 约 0 |
* 上界假设 ground-truth answer token 已知,且 patch 与评估使用同一 hidden state;不代表闭卷泛化。
数学核心
给定末层 hidden state h ∈ R^d:
Logit_j = h · W_U[j]
设当前病态吸引子为 i_toxic = argmax_j (h · W_U[j]),目标为 i_target:
Gap = Logit_{i_toxic} - Logit_{i_target}
ΔLogit_target = Gap + μ
ΔW_U[i_target] = (ΔLogit_target / ||h||_2^2) · h
代入同一 h:
h · (W_U[i_target] + ΔW_U[i_target])
= Logit_{i_target} + (ΔLogit_target / ||h||_2^2)(h · h)
= Logit_{i_toxic} + μ
因此 target 在同一 h 下被数学保证反超。对其它 h_x,影响为:
ΔLogit_target(x) = (Gap + μ) · (||h_x|| / ||h||) · cos(h_x, h)
高维下余弦相似度通常较小,因此影响近似局部化,但不是全局零损伤保证。
Margin 相态
Boost = Logit Gap + μ
μ = 0.001 ~ 0.05:极小作用量态;单次干净输出 target,通常不复读。μ = 1.5 ~ 3.0:各向异性喷流态;定向注入叙事动能,语法通常不崩解。μ > 10.0:超临界坍塌态;logit 偏置过大,易引发复读与退化。
这些是经验性/定性观察,不是普适物理定律。
案例修正
案例 4 中文测试 "中国的首都是" 原输出 "______,是世界上最早" 本身不是正确答案。bit-exact 仅说明该 patch 未改变此 prompt 的输出,不证明正确性,也不证明全局零附带损伤。
30 秒复现
代码与英文版相同。注意:该补丁仅对给定 source_text 的末位 hidden state 生效;换 prompt 不保证;不是 SFT/DPO 替代品。
引用
@misc{aifeifei2026zerotrain,
title={ZeroTrain: Closed-Form Output-Layer Logit Patching via Rank-1 Surgery},
author={aifeifei798 and Gemini},
year={2026},
month={September},
howpublished={\url{https://huggingface.co/}},
note={Jointly Created by aifeifei798 & Gemini. A sci-fi-styled linear algebra demo, not a general fine-tuning method. Released under Apache-2.0 License.}
}
License
Copyright 2026 aifeifei798 & Gemini.
Licensed under the Apache License, Version 2.0.
http://www.apache.org/licenses/LICENSE-2.0