Skip to content

docs: model files build locally — hub-referenced models not supported (#1495) - #77

Draft
LukasWodka wants to merge 1 commit into
developfrom
docs/1495-no-hub-models
Draft

docs: model files build locally — hub-referenced models not supported (#1495)#77
LukasWodka wants to merge 1 commit into
developfrom
docs/1495-no-hub-models

Conversation

@LukasWodka

Copy link
Copy Markdown
Contributor

Documents the #1495 contract on the Customize Models page (join-use-case/model-optimization.mdx):

  • New "Models build locally (no external hubs)" section: a model file must build its architecture from local code; tracebloc does not fetch models/weights/tokenizers/configs from a hub (HuggingFace) at training time. No from_pretrained("<hub-id>"), no model_id/tokenizer_id/hf_token. Start from pretrained by downloading weights once and uploading them; ship a tokenizer.json for NLP.
  • Removes the retired model_id / hf_tokenadditional variables (they now fail upload) and points to the new section.
  • Adds the strict weight-load note (uploaded weights load into the architecture your file builds, matching names/shapes).

⚠️ DRAFT — do not merge until the block ships to prod. docs develop auto-deploys to production, and this describes behavior that isn't live until backend#1505 + tracebloc-py-package#380 reach prod. Un-draft + merge once they're deployed.

Refs #1151 · Documents #1495.

🤖 Generated with Claude Code

… (#1495)
Document the #1495 contract on the Customize Models page: a model file must
build its architecture from local code; tracebloc does not fetch models,
weights, tokenizers, or configs from an external hub (HuggingFace) at training
time. Removes the retired model_id / hf_token 'additional variables' and adds
the pretrained-weights-upload + tokenizer.json guidance and the strict
weight-load note.
Refs #1151. Documents #1495.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@LukasWodkaLukasWodka self-assigned this Aug 4, 2026

@saqlainsyed007saqlainsyed007 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Content LGTM — accurate, and cleanly scoped. Verified:

  • Both internal anchors resolve: #use-pre-trained-weights → the existing Use Pre-trained Weights heading, and the self-reference #models-build-locally-no-external-hubs → this new section's heading.
  • The retired variables are fully removed — no dangling model_id / hf_token / tokenizer_id references remain anywhere in the doc; the only mentions left are the two that deliberately name them as no-longer-supported.
  • The new section documents the #1495 contract at the right place (the canonical Customize Models page), and the strict weight-load Note matches the "build the same architecture" requirement.

Holding the formal approval (commenting, not approving) purely on your own prod-timing gate: docs develop auto-deploys to production, and this describes behavior that isn't live until backend#1505 + tracebloc-py-package#380 reach prod. The content is ready — approve/merge once those are deployed and you un-draft, per your note.

Sign up for freeto 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.

2 participants

@LukasWodka@saqlainsyed007