Skip to content

Commit 6149955

Browse files
authored
Update toml-reference.mdx
1 parent 47465ee commit 6149955

File tree

1 file changed

+38
-38
lines changed

1 file changed

+38
-38
lines changed

toml-reference/toml-reference.mdx

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,44 @@ The `[cerebrium.deployment]` section defines core deployment settings.
3131
they affect the base environment.
3232
</Info>
3333

34+
### UV Configuration
35+
36+
| Option | Type | Default | Description |
37+
| ------ | ------- | ------- | --------------------------------------------- |
38+
| use_uv | boolean | false | Use UV for faster Python package installation |
39+
40+
### UV Package Manager
41+
42+
UV is a fast Python package installer written in Rust that can significantly speed up deployment times. When enabled, UV will be used instead of pip for installing Python dependencies.
43+
44+
<Info>
45+
UV typically installs packages 10-100x faster than pip, especially beneficial for:
46+
47+
- Large dependency trees
48+
- Multiple packages
49+
- Clean builds without cache
50+
51+
</Info>
52+
53+
**Example with UV enabled:**
54+
55+
```toml
56+
[cerebrium.build]
57+
use_uv = true
58+
```
59+
60+
### Monitoring UV Usage
61+
62+
Check your build logs for these indicators:
63+
64+
- **UV_PIP_INSTALL_STARTED** - UV is successfully being used
65+
- **PIP_INSTALL_STARTED** - Standard pip installation (when `use_uv=false`)
66+
67+
<Warning>
68+
While UV is compatible with most packages, some edge cases may cause build
69+
failures, such as legacy packages with non-standard metadata.
70+
</Warning>
71+
3472
## Runtime Configuration
3573

3674
The `[cerebrium.runtime.custom]` section configures custom web servers and runtime behavior.
@@ -146,44 +184,6 @@ apt = "pkglist.txt"
146184
conda = "conda_pkglist.txt"
147185
```
148186

149-
### UV Configuration
150-
151-
| Option | Type | Default | Description |
152-
| ------ | ------- | ------- | --------------------------------------------- |
153-
| use_uv | boolean | false | Use UV for faster Python package installation |
154-
155-
### UV Package Manager
156-
157-
UV is a fast Python package installer written in Rust that can significantly speed up deployment times. When enabled, UV will be used instead of pip for installing Python dependencies.
158-
159-
<Info>
160-
UV typically installs packages 10-100x faster than pip, especially beneficial for:
161-
162-
- Large dependency trees
163-
- Multiple packages
164-
- Clean builds without cache
165-
166-
</Info>
167-
168-
**Example with UV enabled:**
169-
170-
```toml
171-
[cerebrium.build]
172-
use_uv = true
173-
```
174-
175-
### Monitoring UV Usage
176-
177-
Check your build logs for these indicators:
178-
179-
- **UV_PIP_INSTALL_STARTED** - UV is successfully being used
180-
- **PIP_INSTALL_STARTED** - Standard pip installation (when `use_uv=false`)
181-
182-
<Warning>
183-
While UV is compatible with most packages, some edge cases may cause build
184-
failures, such as legacy packages with non-standard metadata.
185-
</Warning>
186-
187187
## Complete Example
188188

189189
```toml

0 commit comments

Comments
 (0)