Skip to content

docs(readme): bring the README back in line with the code - #157

Merged
dadaism merged 1 commit into
mainfrom
docs/readme-drift
Nov 12, 2026
Merged

dadaism merged 1 commit into
mainfrom
docs/readme-drift

Conversation

@dadaism

@dadaism dadaism commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Docs-only. After the logo PR (#155) I read the whole README against the code; these are the places where it had drifted. Each item names what it was checked against.

Change Checked against
Hardware support: new row for the native PyTorch neuron backend (Trainium2/3, FP8 on Trainium3); AOT row labelled; CUDA row lists HunyuanVideo and LTX-2 as experimental difflet/platforms/__init__.py PLATFORM_FACTORIES, docs/verification/neuron-backend-results.md, the NVIDIA feature table, #147
Detection order: neuron → trainium → tpu → cuda → rocm, fallback trainium difflet/platforms/__init__.py:33 and detect_platform_name
Footnotes renumbered: GPU notes 1–8 unchanged, Trainium notes 7–15 → 9–17 so ⁷/⁸ no longer mean two things; GPU note 8 rejoined to its list script check: every superscript resolves to exactly one note
Latest news: ISO dates; "Difflet 1.0 is released" → "First public release" pyproject.toml version = "0.0.0.dev0", the pre-alpha badge
Prerequisites: Trainium3 via --backend neuron; --quant mxfp8 Trainium3-only difflet/cli/quant.py help text
CLI flags table: --backend, --torch-compile, --quant, --dp-degree, --negative-prompt/--true-cfg-scale, --host-vae/--device-vae difflet/cli/main.py _build_parser and the _add_*_flags helpers (which subcommands get each flag)
Observability: describe today's logs only; the .claude/skills/ plan was a maintainer note —
Tagline absorbs the stray MiniMax-H3 sentence; torch pin comment points at requirements-cuda.lock requirements-cuda.lock:80
pyproject.toml: add the 3.13 classifier (list had 3.11, 3.12, 3.14) CI runs the native job on py3.14

Not changed, flagged for a decision: requires-python = ">=3.11" while unit-cpu.yml still has a py3.10 matrix entry — one of the two should move.

Test plan

  • Every ](#anchor) in README resolves to a heading; every relative link exists
  • Footnote script: references 1–17 ⊆ notes 1–17, no duplicate note numbers
  • Rich diff of README.md on this PR reads correctly (tables render, note lists start at 1 and 9)

🤖 Generated with Claude Code

Fix claims that drifted since the GPU-first rewrite, each checked against
the source it describes:

- Hardware support: add the native PyTorch `neuron` backend (Trainium2/3,
  FP8 on Trainium3), label the AOT row, list HunyuanVideo and LTX-2 as
  experimental on CUDA.
- Backend detection order is neuron, trainium, tpu, cuda, rocm, falling
  back to trainium (difflet/platforms/__init__.py); say so.
- Footnotes: GPU notes 1-8 and Trainium notes 7-15 shared superscripts;
  Trainium notes are now 9-17 so every reference is unique. Rejoin GPU
  note 8 to its list.
- Latest news: ISO dates; "1.0 is released" conflicts with the pre-alpha
  badge and pyproject's 0.0.0.dev0, so it is now "First public release".
- Prerequisites: Trainium3 via the native backend.
- CLI flags table: add --backend, --torch-compile, --quant, --dp-degree,
  --negative-prompt/--true-cfg-scale, --host-vae/--device-vae, which the
  README already uses.
- Observability: describe today's logs; drop the maintainer plan.
- Fold the MiniMax-H3 sentence into the tagline; tie the torch pin to
  requirements-cuda.lock.
- pyproject: add the 3.13 classifier (3.11, 3.12 and 3.14 were listed).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@dadaism
dadaism merged commit cbcc447 into main Nov 12, 2026
4 checks passed
@dadaism
dadaism deleted the docs/readme-drift branch November 12, 2026 09:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant