Skip to main content
The vlmrun predictions command lets you list and retrieve prediction results.

​
List Predictions

# List recent predictions (default: last 10)
vlmrun predictions list

# Filter by status
vlmrun predictions list --status completed
vlmrun predictions list --status failed

# Filter by date range
vlmrun predictions list --since 2026-03-01 --until 2026-03-30

# Pagination
vlmrun predictions list --limit 25 --skip 10
OptionDescription
--limitMax items to return (default: 10)
--skipNumber of items to skip (default: 0)
--statusFilter by status: enqueued, pending, running, completed, failed, paused
--sinceShow predictions since date (YYYY-MM-DD)
--untilShow predictions until date (YYYY-MM-DD)

​
Get Prediction

# Get prediction details
vlmrun predictions get <prediction-id>

# Wait for a prediction to complete (useful for batch jobs)
vlmrun predictions get <prediction-id> --wait

# Wait with custom timeout
vlmrun predictions get <prediction-id> --wait --timeout 120
Argument/OptionDescription
PREDICTION_IDID of the prediction to retrieve (required)
--waitWait for prediction to complete (default: --no-wait)
--timeoutTimeout in seconds when waiting (default: 60)