Skip to main content
The download command supports two modes of operation:
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