OpenMythos

kyegomezMIT更新放缓

从公开研究文献出发,用第一性原理复现 Claude Mythos 架构的理论实现,供研究者拆解其注意力机制与模型设计思路。

A theoretical reconstruction of the Claude Mythos architecture, built from first principles using the available research literature.

暂无版本14,923star +1 / 7 天3,265fork同步于 2026-11-10 11:26 UTC

怎么上手

由 README 提炼,执行前请确认
pip install open-mythos
硬件要求按 README 说明

README 未说明显存要求;训练脚本按 H100/A100 使用 bfloat16、旧 GPU 使用 float16 加 GradScaler,Flash Attention 2 需要 CUDA 与编译工具

需要 CUDA多卡 / 张量并行
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

用 PyTorch 从公开文献重建 Claude Mythos 的循环深度 Transformer,供研究复现与实验

从公开研究文献出发,用第一性原理复现 Claude Mythos 架构的理论实现,供研究者拆解其注意力机制与模型设计思路。

核心能力

  • 实现 Prelude、循环 Recurrent Block 与 Coda 三段式 RDT
  • 注意力可在 MLA 与 GQA 之间切换
  • 前馈采用含路由专家与共享专家的稀疏 MoE
  • 用对角负矩阵参数化注入,保证谱半径小于 1
  • 提供 1B 到 1T 的预配置模型规模

容易踩的坑

Flash Attention 2 需额外安装 open-mythos[flash] 并具备 CUDA 与编译工具;训练脚本默认从 HuggingFace 拉取 fineweb-edu 数据集和 gpt-oss-20b 分词器,需联网下载;README 示例调用了未在变体列表中定义的 mythos_7b,实际使用请选表中已有的规模函数

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    OpenMythos

    Disclaimer: OpenMythos is an independent, community-driven theoretical reconstruction based solely on publicly available research and speculation. It is not affiliated with, endorsed by, or connected to Anthropic or any of their proprietary systems.

    OpenMythos is an open-source, theoretical implementation of the Claude Mythos model. It implements a Recurrent-Depth Transformer (RDT) with three stages: Prelude (transformer blocks), a looped Recurrent Block (up to max_loop_iters), and a final Coda. Attention is switchable between MLA and GQA, and the feed-forward uses a sparse MoE with routed and shared experts ideal for exploring compute-adaptive, depth-variable reasoning.

    Installation

    pip install open-mythos
    
    #uv pip install open-mythos
    

    To enable Flash Attention 2 in GQAttention (requires CUDA and build tools):

    pip install open-mythos[flash]
    

    Usage

    
    import torch
    from open_mythos.main import OpenMythos, MythosConfig
    
    
    attn_type = "mla"  # or "gqa"
    
    base = {
        "vocab_size": 1000,
        "dim": 256,
        "n_heads": 8,
        "max_seq_len": 128,
        "max_loop_iters": 4,
        "prelude_layers": 1,
        "coda_layers": 1,
        "n_experts": 8,
        "n_shared_experts": 1,
        "n_experts_per_tok": 2,
        "expert_dim": 64,
        "lora_rank": 8,
        "attn_type": attn_type,
    }
    
    if attn_type == "gqa":
        cfg = MythosConfig(**base, n_kv_heads=2)
    else:
        cfg = MythosConfig(
            **base,
            n_kv_heads=8,
            kv_lora_rank=32,
            q_lora_rank=64,
            qk_rope_head_dim=16,
            qk_nope_head_dim=16,
            v_head_dim=16,
        )
    
    model = OpenMythos(cfg)
    total = sum(p.numel() for p in model.parameters())
    print(f"\n[{attn_type.upper()}] Parameters: {total:,}")
    
    ids = torch.randint(0, cfg.vocab_size, (2, 16))
    logits = model(ids, n_loops=4)
    print(f"[{attn_type.upper()}] Logits shape: {logits.shape}")
    
    out = model.generate(ids, max_new_tokens=8, n_loops=8)
    print(f"[{attn_type.upper()}] Generated shape: {out.shape}")
    
    A = model.recurrent.injection.get_A()
    rho = torch.linalg.eigvals(A).abs().max().item()
    print(
        f"[{attn_type.upper()}] Spectral radius ρ(A) = {rho:.4f} (must be < 1)"
    )
    

    Model Variants

    Pre-configured scales from 1B to 1T parameters:

    from open_mythos import (
        mythos_1b,
        mythos_3b,
        mythos_10b,
        mythos_50b,
        mythos_100b,
        mythos_500b,
        mythos_1t,
        OpenMythos,
    )
    
    cfg = mythos_7b()  # returns a MythosConfig
    model = OpenMythos(cfg)
    
    total = sum(p.numel() for p in model.parameters())
    print(f"Parameters: {total:,}")
    
    VariantdimExpertsexpert_dimLoop itersContextMax output
    mythos_1b2048642048164k4k
    mythos_3b3072644096164k4k
    mythos_10b40961285632248k4k
    mythos_50b61442569728328k4k
    mythos_100b819225613568321M128k
    mythos_500b1228851223040481M128k
    mythos_1t1638451234560641M128k

    Training

    The training script for the 3B model on FineWeb-Edu is at training/3b_fine_web_edu.py.

    Single GPU:

    python training/3b_fine_web_edu.py
    

    Multi-GPU (auto-detects GPU count):

    torchrun --nproc_per_node=$(python -c "import torch; print(torch.cuda.device_count())") training/3b_fine_web_edu.py
    

    Key design choices:

    FeatureDetail
    OptimizerAdamW
    DatasetHuggingFaceFW/fineweb-edu (sample-10BT by default, swap to sample-100BT or default for full run)
    Tokenizeropenai/gpt-oss-20b via MythosTokenizer
    ParallelismPyTorch DDP via torchrun, sharded streaming dataset
    Precisionbfloat16 on H100/A100, float16 + GradScaler on older GPUs
    ScheduleLinear warmup (2000 steps) → cosine decay
    Target30B tokens (~Chinchilla-adjusted for looped architecture)

    Documentation

    PageDescription
    docs/open_mythos.mdFull API reference for the OpenMythos class — constructor, forward, generate, all sub-modules, configuration reference, and usage examples
    docs/datasets.mdRecommended training datasets with token budget guidance per model size

    The Central Hypothesis

    Claude Mythos is suspected to be a Recurrent-Depth Transformer (RDT) — also called a Looped Transformer (LT). Rather than stacking hundreds of unique layers, a subset of layers is recycled and run through multiple times per forward pass. Same weights. More loops. Deeper thinking.

    This is not chain-of-thought. There is no intermediate token output. All of this reasoning happens silently, inside a single forward pass, in continuous latent space.


    Architecture

    A looped transformer divides its layers into three functional blocks:

    Input
      ↓
    [Prelude P]        — standard transformer layers, run once
      ↓
    [Recurrent Block R] — looped T times
      ↑_______↓         (hidden state h updated each loop with input injection e)
      ↓
    [Coda C]           — standard transformer layers, run once
      ↓
    Output
    

    The recurrent block update rule at each loop step t:

    h_{t+1} = A·h_t + B·e + Transformer(h_t, e)
    

    Where:

    • h_t is the hidden state after loop t
    • e is the encoded input (from the Prelude), injected at every loop
    • A and B are learned injection parameters
    • The Transformer blocks apply attention and MLP as usual

    The injection of e at every step is what prevents the model from drifting — it keeps the original input signal alive throughout the entire recurrence depth.

    The full implementation is in open_mythos/main.py. See the OpenMythos class reference for a detailed API walkthrough, configuration options, and usage examples.

    Attention Implementations

    The attention layer is switchable via cfg.attn_type:

    OptionClassDescription
    "gqa"GQAttentionGrouped Query Attention (Ainslie et al., 2023) — fewer KV heads than Q heads (n_kv_heads < n_heads), reducing KV-cache memory by n_heads / n_kv_heads. Uses Flash Attention 2 (Dao et al., 2023) when flash-attn>=2.8.3 is installed: GQA is handled natively (no KV head expansion), I/O-bound-optimal, with a transparent fallback to manual scaled dot-product attention when the package is absent.
    "mla"MLAttentionMulti-Latent Attention (DeepSeek-V2) — caches a compressed KV latent (kv_lora_rank) rather than full K/V, with split RoPE / no-RoPE head dims for position-aware compression.

    RoPE is applied to Q and K before caching, so cached values do not need to be re-rotated on retrieval.


    Why This Explains Mythos

    1. Systematic Generalization

    Vanilla transformers fail to combine knowledge in ways they have never seen during training. Looped transformers pass this test. The ability emerges through a three-stage grokking process:

    1. Memorization — model fits training distribution
    2. In-distribution generalization — model handles known compositions
    3. Systematic generalization — model handles novel compositions OOD, abruptly and suddenly

    This is why Mythos feels qualitatively different from other models on novel questions — the capability phase-transitions in, rather than emerging gradually.

    2. Depth Extrapolation

    Train on 5-hop reasoning chains. Test on 10-hop. Vanilla transformer fails. Looped transformer succeeds — by running more inference-time loops. This maps directly to the observation that Mythos handles deeply compositional problems (multi-step math, long-horizon planning, layered arguments) without explicit chain-of-thought.

    More loops at inference = deeper reasoning chains = harder problems solved.

    3. Latent Thoughts as Implicit Chain-of-Thought

    Each loop iteration is the functional equivalent of one step of chain-of-thought, but operating in continuous latent space rather than token space. A looped model running T loops implicitly simulates T steps of CoT reasoning. This has been formally proven (Saunshi et al., 2025).

    Furthermore, continuous latent thoughts — unlike discrete token outputs — can encode multiple alternative next steps simultaneously. This allows something closer to breadth-first search over the reasoning space, rather than a single committed reasoning path. The model is effectively exploring many possible directions inside each forward pass before converging.

    4. No Parameter Explosion

    A looped model with k layers run L times achieves the quality of a kL-layer non-looped model, with only k layers worth of parameters. For Mythos-scale deployments, this matters enormously:

    • Memory footprint does not grow with reasoning depth
    • Inference-time compute scales with loop count, not model size
    • This makes deeper reasoning "free" in terms of parameters

    The Stability Problem (and How It Was Likely Solved)

    Training looped models is notoriously unstable. Two failure modes dominate:

    • Residual explosion — the hidden state h_t grows unboundedly across loops
    • Loss spikes — training diverges suddenly due to large spectral norms in injection parameters

    The Dynamical Systems View

    Recast looping as a discrete linear time-invariant (LTI) dynamical system over the residual stream. Ignoring the nonlinear Transformer contribution, the recurrence becomes:

    h_{t+1} = A·h_t + B·e
    

    For this LTI system, stability is governed entirely by the spectral radius of A:

    • ρ(A) < 1 → stable, convergent
    • ρ(A) ≥ 1 → unstable, divergent

    Empirically, every divergent training run learns ρ(A) ≥ 1. Every convergent run maintains ρ(A) < 1.

    The Fix

    Constrain the injection parameters so that stability is guaranteed by construction:

    1. Parameterize A as a continuous negative diagonal matrix
    2. Discretize using ZOH/Euler schemes: A_discrete = exp(Δt · A_continuous)
    3. Enforce negativity via A := Diag(-exp(log_A)) with a learned scalar Δt
    4. This ensures ρ(A) < 1 always holds, regardless of learning rate or batch noise

    The result: the looped model becomes significantly more robust to hyperparameter selection and trains cleanly even at high learning rates. This is the Parcae architecture (Prairie et al., 2026), and it represents the most likely class of solution Anthropic used to make Mythos trainable.


    Scaling Laws for Looped Models

    Parcae establishes the first predictable scaling laws for looped training:

    • Training: For a fixed FLOP budget with fixed parameters, increasing mean recurrence and reducing token count yields a lower loss than training with minimal loops on more data. Optimal recurrence and optimal token count both follow power laws with consistent exponents across scales.
    • Inference: More test-time loops improves quality following a predictable, saturating exponential decay — gains are real but diminishing. This mirrors the inference-time scaling of chain-of-thought.

    At 770M parameters, a looped model achieves the downstream quality of a 1.3B fixed-depth Transformer trained on the same data — roughly half the parameters for the same quality.

    Applied to Mythos: if trained under these scaling laws, Mythos could be dramatically more parameter-efficient than it appears, with a large fraction of its apparent "capability" coming from loop depth rather than raw parameter count.


    The Loop Index Embedding Hypothesis

    A key open question is whether the looped block behaves identically on every iteration, or whether it can learn to do different things at different loop depths.

    Without any positional signal across loops, the same weights must handle both early-stage pattern matching and late-stage refinement — a tight constraint. A RoPE-like embedding of the loop index injected alongside the input at each step would allow the same parameters to implement functionally distinct operations across iterations, much like how RoPE allows the same attention heads to behave differently at different sequence positions.

    If Mythos uses this technique, each loop is not a repetition — it is a distinct computational phase, all sharing weights but operating in different representational regimes. This would substantially increase the expressiveness of the recurrent block without increasing parameter count.


    The Overthinking Problem

    More loops is not always better. Beyond a certain depth, excessive recurrence degrades predictions — the hidden state drifts past the solution and into noise. This is the "overthinking" failure mode.

    The original Universal Transformer (Dehghani et al., 2018) addressed this with an Adaptive Computation Time (ACT) halting mechanism: a learned scalar per position that dynamically decides when to stop looping. Positions that are harder to process receive more computation; simple tokens halt early.

    Mythos almost certainly has some version of this. The model cannot naively run the maximum number of loops on every input — it needs a learned signal for when the answer has converged. The ACT mechanism also makes the model Turing-complete under certain assumptions, which has theoretical implications for the class of problems it can solve.


    Mixture of Experts — Suspected for Large Parameter Counts

    The looped transformer explains the depth of Mythos's reasoning, but not the breadth. Handling wildly different domains — code, math, literature, science, law — with the same weights requires Mixture of Experts (MoE). The suspected design replaces every FFN in the Recurrent Block with a fine-grained MoE layer: each FFN is split into many small experts (1/m the normal size), a router selects the top-mK of them per token via learned affinity scores, and a small number of shared experts are always activated regardless of routing to absorb common cross-domain knowledge — syntax, basic reasoning, general context — that would otherwise be redundantly learned by every routed expert. Routing collapse is prevented through a bias term on the router logits adjusted dynamically during training, keeping load balanced across experts without distorting the loss signal.

    As the hidden state h_t evolves across loop iterations, the router may select different expert subsets at each depth, making every loop computationally distinct despite shared weights. MoE provides breadth; looping provides depth. If the activation ratio is ~5%, Mythos could hold hundreds of billions of total parameters while activating only a small fraction per token — the true parameter count, if ever disclosed, would be a storage number, not a compute number.


    The Memorization-Reasoning Tradeoff

    Looped models exhibit an interesting dichotomy: looping improves reasoning but can hurt memorization. The recurrent structure is optimized for iterative composition — running a reasoning chain forward — but does not inherently improve the storage of rote facts.

    This maps to an observable characteristic of Mythos: it reasons exceptionally well about novel problems it has never seen, but its factual recall can be inconsistent. The architecture is structurally biased toward composition over memorization.

    Looping-based regularization (Saunshi et al., 2025) can be used to balance this tradeoff during training — applying stronger looping constraints for reasoning tasks while relaxing them for retrieval tasks.


    Parameter Reuse via LoRA Adaptation

    A complementary approach from Relaxed Recursive Transformers (Bae et al., 2024): rather than requiring fully identical weights at every loop, add a small depth-wise LoRA module at each iteration. This preserves the compactness of weight sharing while allowing each loop to adapt its behavior slightly.

    The result:

    • Each loop shares a large common weight matrix (the recursive base)
    • A small rank-r adaptation matrix shifts behavior per iteration depth
    • The total parameter overhead is minimal

    This bridges the gap between pure weight-tying (maximally parameter-efficient, less expressive) and fully distinct layers (maximally expressive, no parameter savings). Mythos likely sits somewhere on this spectrum.


    Continuous Depth-wise Batching

    A downstream consequence of the recursive architecture: Continuous Depth-wise Batching. Because all tokens share the same recurrent block, the model can exit the loop at different depths for different tokens or sequences — processing easy inputs quickly and hard inputs with more iterations, all within the same batch.

    Theoretical analysis suggests 2-3x improvements in inference throughput. For a deployed model like Mythos serving many users simultaneously, this would be a substantial efficiency gain.


    Summary: What Mythos Probably Is

    PropertyDescription
    ArchitectureRecurrent-Depth Transformer (Prelude + Looped Recurrent Block + Coda)
    FFN layerSuspected MoE — fine-grained experts + always-on shared experts
    Parameter countVery large total; small fraction activated per token (~5% estimate)
    Reasoning mechanismImplicit multi-hop via iterative latent updates — no token output between steps
    Inference-time scalingMore loops = deeper reasoning, following predictable exponential decay
    Training stabilityLTI-constrained injection parameters with spectral radius < 1
    Loop differentiationLikely uses loop-index positional embedding (à la RoPE) per iteration
    HaltingAdaptive Computation Time or learned convergence criterion
    AttentionGQA (with optional Flash Attention 2) or MLA with compressed KV latent cache
    Scaling lawOptimal training scales looping and data together, not parameters alone
    Reasoning vs. memoryStructurally biased toward composition; memorization requires separate treatment
    DeploymentContinuous Depth-wise Batching enables variable compute per request

    References

    Twitter / X

    Papers


    Citation

    If you use OpenMythos in your research or build on this work, please cite:

    @software{gomez2026openmythos,
      author    = {Kye Gomez},
      title     = {OpenMythos: A Theoretical Reconstruction of the Claude Mythos Architecture},
      year      = {2026},
      url       = {https://github.com/kyegomez/OpenMythos},
      note      = {Recurrent-Depth Transformer with MoE, MLA, LTI-stable injection, and ACT halting}
    }
    

    License

    MIT License — Copyright (c) 2026 Kye Gomez. See LICENSE for the full text.