Download - 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.

The download command supports two modes of operation:

LEAP Model Download
Bundle Request Download

Download GGUF files for a model from the LEAP Model Library. Does not require authentication.

leap-bundle download <model-name> [--quantization <quantization>] [--output-path <path>] [--overwrite]

Arguments

model-name (required): Name of the model to download from the LEAP Model Library

Options

--quantization <quantization>: Quantization level to download for the model. You can find available quantization levels for each model in the LEAP Model Library. Defaults to Q5_K_M if not specified.
--output-path <path>: Directory to save the downloaded files. If not specified, auto-generates a directory name based on the manifest URL.
--overwrite: By default, if the JSON file already exists in the output path, the command will throw an error. With this flag, the existing file will be overwritten.

Behavior

Create an output directory based on the URL or according to --output-path if specified.
Download the JSON manifest file.
Download all model files referenced in load_time_parameters in the manifest
Update the local manifest to use relative paths to the downloaded files.

Examples

# Download from manifest URL (auto-generates directory name)
leap-bundle download LFM2-1.2B --quantization Q5_K_M

# Example output
ℹ Verifying URL returns JSON content...
ℹ No output path specified, using: <default_path>
ℹ Downloading manifest from https://huggingface.co/LiquidAI/LeapBundles/resolve/main/LFM2-1.2B-GGUF/Q5_K_M.json...
⠙ Downloading manifest completed!
✓ Manifest downloaded to <default_path>/Q5_K_M.json
ℹ Found 2 parameters in load_time_parameters
ℹ Downloading model: LFM2-1.2B-Q5_K_M.gguf...
⠼ Downloading LFM2-1.2B-Q5_K_M.gguf completed!
✓ Downloaded LFM2-1.2B-Q5_K_M.gguf
✓ Manifest updated with relative paths: <default_path>/Q5_K_M.json
✓ All files downloaded successfully to: <default_path>

Manifest FormatThe JSON manifest should contain a load_time_parameters section with URLs to model files:

{
  "load_time_parameters": {
    "model_path": "https://example.com/model.gguf",
    "vocab_path": "https://example.com/vocab.gguf"
  }
}

After download, the manifest is updated to use relative paths:

{
  "load_time_parameters": {
    "model_path": "./model.gguf",
    "vocab_path": "./vocab.gguf"
  }
}

Error Cases

Invalid URL: Shows URL validation error
Manifest not found: Shows HTTP 404 error
Invalid JSON: Shows JSON parsing error
Model file download failure: Shows download error
Output directory creation failure: Shows file system error
Network issues: Shows connection error

Download the model files for a completed bundle request. Requires authentication via leap-bundle login.

leap-bundle download <request-id> [--output-path <path>]

Arguments

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

Options

--output-path <path>: Directory to save the downloaded files (default: current directory)

Behavior

Requests signed download URLs from the LEAP platform
Downloads the model files using the signed URLs
Saves files with default names or to the specified output path
GGUF requests may produce multiple .gguf files; ExecuTorch requests produce a single .bundle file

Examples

# Download GGUF bundle request to current directory
leap-bundle download 18734

# Example output
ℹ Requesting download for bundle request 18734...
✓ Download URL obtained for request 18734
Downloading bundle output... ✓
✓ Download completed successfully! File saved to: model-Q4_K_M.gguf

# Download to specific directory
leap-bundle download 18734 --output-path ./downloads/

# Example output
ℹ Requesting download for bundle request 18734...
✓ Download URL obtained for request 18734
Downloading bundle output... ✓
✓ Download completed successfully! File saved to: downloads/model-Q4_K_M.gguf

Error Cases

Request not found: Shows request not found error
Request not completed: Shows status error (request must be in “completed” status)
Request already archived: Shows archived error
Output directory doesn’t exist: Shows directory not found error
Output path is not a directory: Shows invalid path error
Download failure: Shows network or file system error
Not authenticated: Prompts to login first

Only requests with “completed” status can be downloaded. Check the request status using leap-bundle list <request-id> before attempting to download.

A completed request will be automatically archived 5 days after completion. You will not be able to download it afterwards.