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_token additional 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>
@LukasWodka LukasWodka self-assigned this Aug 4, 2026
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