Skip to content

Commit 848bbfe

Browse files
committed
docs: clarify local model filesystem path requirements
1 parent 23ff67f commit 848bbfe

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

‎docs/docs/01-fundamentals/02-downloading-models.md‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,18 @@ A model source is either remote or local:
3333
[`models`](../06-api-reference/variables/models.md) registry. Each entry bundles
3434
every file a pipeline needs behind one object. This registry is the single source
3535
of truth for the tuned, ready-to-run models.
36-
- **Your own models** are plain URLs or local paths — a file bundled with the app,
37-
a `file://` path, or a URL on your own host (see
36+
- **Your own models** use `http(s)` URLs or absolute local filesystem paths (see
3837
[Exporting Custom Models](../03-core-and-advanced/07-exporting-custom-models.md)).
3938

4039
Local paths are always passed through untouched; only `http(s)` URLs are ever
41-
downloaded.
40+
downloaded. Loaders require filesystem paths such as `/path/to/model.pte`;
41+
`file://` URIs are not supported. If a document picker returns a `file://` URI,
42+
convert it to an absolute filesystem path before passing it to a hook or pipeline
43+
factory. This applies to every file in the config, including tokenizer and
44+
tokenizer config files.
45+
46+
Paths returned by `download()` are already filesystem paths. Pass them directly
47+
to a pipeline factory without adding a `file://` prefix.
4248

4349
## Automatic downloading with hooks
4450

0 commit comments

Comments
 (0)