Skip to content

docs: Document min_cuda_version parameter for Flash GPU endpoints #593

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
promptless wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

docs: Document min_cuda_version parameter for Flash GPU endpoints #593

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions flash/configuration/parameters.mdx
View file
Open in desktop
Copy link
Contributor Author

@promptless promptless bot Mar 24, 2026

Choose a reason for hiding this comment

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

(Line 474)

Citation: New min_cuda_version parameter added to Endpoint class in src/runpod_flash/endpoint.py. Default value of "12.8" set in src/runpod_flash/core/resources/serverless.py. CPU endpoints clear this value via _sync_cpu_fields() in serverless_cpu.py.
View source

Copy link
Contributor Author

@promptless promptless bot Mar 24, 2026

Choose a reason for hiding this comment

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

(Line 500)

Citation: Valid CUDA versions are validated against the CudaVersion enum via validate_min_cuda_version() in serverless.py. The error message format and validation logic are defined in the PR.
View source

Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ This page provides a complete reference for all parameters available on the `End
| `scaler_type` | `ServerlessScalerType` | Scaling strategy | auto |
| `scaler_value` | `int` | Scaling threshold | `4` |
| `template` | `PodTemplate` | Pod template overrides | `None` |
| `min_cuda_version` | `str` | Minimum CUDA version for GPU host selection | `"12.8"` (GPU) / `None` (CPU) |

## Parameter details

Expand Down Expand Up @@ -537,6 +538,35 @@ template = PodTemplate(
For simple environment variables, use the `env` parameter on `Endpoint` instead of `PodTemplate.env`.
</Tip>

### min_cuda_version

**Type**: `str`
**Default**: `"12.8"` for GPU endpoints, `None` for CPU endpoints

Specifies the minimum CUDA driver version required on the host machine. GPU endpoints default to `"12.8"` to ensure workers run on hosts with recent CUDA drivers.

```python
from runpod_flash import Endpoint, GpuType

# Use the default (12.8)
@Endpoint(name="ml-inference", gpu=GpuType.NVIDIA_A100_80GB_PCIe)
async def infer(data): ...

# Override to allow older hosts
@Endpoint(
name="legacy-compatible",
gpu=GpuType.NVIDIA_A100_80GB_PCIe,
min_cuda_version="12.4"
)
async def infer_legacy(data): ...
```

This parameter has no effect on CPU endpoints.

<Note>
Valid CUDA versions include: `"11.1"`, `"11.4"`, `"11.7"`, `"11.8"`, `"12.0"`, `"12.1"`, `"12.2"`, `"12.3"`, `"12.4"`, `"12.6"`, `"12.8"`. Invalid values raise a `ValueError`.
</Note>

## EndpointJob

When using `Endpoint(id=...)` or `Endpoint(image=...)`, the `.run()` method returns an `EndpointJob` object for async operations:
Expand Down Expand Up @@ -576,6 +606,7 @@ These changes restart all workers:
- Storage (`volume`)
- Datacenter (`datacenter`)
- Flashboot setting (`flashboot`)
- CUDA version requirement (`min_cuda_version`)

Workers are temporarily unavailable during recreation (typically 30-90 seconds).

Expand Down
Loading