Bundle Management - Liquid AI Docs

The LEAP Model Bundling Service is deprecated and no longer maintained. For new deployments, download GGUF files from Hugging Face and run them with llama.cpp.

`list`

List bundle requests or get details for a specific request.

leap-bundle list [<request-id>]

Arguments

request-id (optional): Specific request ID to get detailed information

Options

--json: Output result in JSON format for programmatic parsing
--last: Show only the most recent request

Behavior

Without arguments: Lists 50 most recent bundle requests
With request ID: Shows detailed information for the specific request
With --last: Shows only the most recent request
Displays requests in a formatted table (unless --json is used)
JSON output available for both list and specific request queries

Examples

# List all requests
leap-bundle list

# Example output
Bundle Requests (50 most recent)
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
│ 18733 │ /path/to/other/directory │ processing │ 2024-01-15T09:15:00Z │ Request is being processed. │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 2 bundle requests.

# Get details for specific request
leap-bundle list 18734

# Example output
✓ Request Details:
  ID:         18734
  Input Path: /path/to/model/directory
  Status:     completed
  Creation:   2024-01-15T10:30:00Z
  Update:     2024-01-15T10:45:00Z
  Notes:      Processing completed. Run "leap-bundle download 18734" to download the bundle.

# Get details with JSON output
leap-bundle list 18734 --json

# Example JSON output
{
  "request_id": "18734",
  "input_path": "/path/to/model/directory",
  "status": "completed",
  "created_at": "2024-01-15T10:30:00Z",
  "user_message": "Processing completed. Run \"leap-bundle download 18734\" to download the bundle."
}

# List all requests with JSON output
leap-bundle list --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    },
    {
      "request_id": "18733",
      "input_path": "/path/to/other/directory",
      "status": "processing",
      "created_at": "2024-01-15T09:15:00Z",
      "user_message": "Request is being processed."
    }
  ]
}

# Show only the most recent request
leap-bundle list --last

# Example output
Most Recent Bundle Request
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID    ┃ Input Path               ┃ Status     ┃ Creation             ┃ Notes                       ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 18734 │ /path/to/model/directory │ completed  │ 2024-01-15T10:30:00Z │ Processing completed.       │
└───────┴──────────────────────────┴────────────┴──────────────────────┴─────────────────────────────┘
✓ Found 1 bundle request.

# Show most recent request with JSON output
leap-bundle list --last --json

# Example JSON output
{
  "requests": [
    {
      "request_id": "18734",
      "input_path": "/path/to/model/directory",
      "status": "completed",
      "created_at": "2024-01-15T10:30:00Z",
      "user_message": "Processing completed."
    }
  ]
}

Request Statuses

New: The request is newly created
Uploading: The model files are being uploaded
Uploading Failed: The upload encountered an error
Processing: The bundle is being processed
Processing Failed: Processing failed
Completed: The request is successfully completed and ready for download
Cancelled: The request is cancelled by the user
Archived: The request is archived and no longer available for download; this happens automatically 5 days after completion

Error Cases

Not authenticated: Prompts to login first
Request ID not found: Shows not found error
Network issues: Shows connection error

`cancel`

Cancel a bundle request that is still processing.

leap-bundle cancel <request-id>

Arguments

request-id (required): ID of the bundle request to cancel

Behavior

Sends a cancellation request to the LEAP platform
Updates the request status to “cancelled”
Cannot cancel requests that are already completed or archived

Examples

# Cancel a processing request
leap-bundle cancel 18734

# Example output on success
ℹ Cancelling bundle request 18734...
✓ Request cancelled successfully.

# Example output when request is already completed
ℹ Cancelling bundle request 18734...
✓ Request was already completed and cannot be cancelled.

Error Cases

Request not found: Shows request not found error
Request already completed: Shows informational message
Not authenticated: Prompts to login first
Network issues: Shows connection error