From 5df8009cff9482a247d05101b57830ba943503d2 Mon Sep 17 00:00:00 2001 From: Darian Bhathena Date: Tue, 16 Dec 2025 16:45:18 -0500 Subject: [PATCH 1/4] update cli spec --- leap/leap-bundle/cli-spec.mdx | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/leap/leap-bundle/cli-spec.mdx b/leap/leap-bundle/cli-spec.mdx index ae104db..3f0c64e 100644 --- a/leap/leap-bundle/cli-spec.mdx +++ b/leap/leap-bundle/cli-spec.mdx @@ -584,7 +584,7 @@ leap-bundle list --last --json This command supports two modes of operation: 1. **Bundle Request Download**: Download a generated model bundle file from a completed request -2. **Manifest Download**: Download GGUF model files from a JSON manifest URL +2. **LEAP Model Download**: Download GGUF model files for a model from the [LEAP Model Library](https://leap.liquid.ai/models) #### Mode 1: Bundle Request Download @@ -650,12 +650,12 @@ A completed request will be automatically archived 5 days after completion. You to download it afterwards. ::: -#### Mode 2: Manifest Download +#### Mode 2: LEAP Model Download -Download GGUF model files from a JSON manifest URL. +Download GGUF files for a model from the [LEAP Model Library](https://leap.liquid.ai/models). ```sh -leap-bundle download [--output-path ] [--overwrite] +leap-bundle download [--quantization ] [--output-path ] [--overwrite] ``` **Arguments** @@ -664,6 +664,7 @@ leap-bundle download [--output-path ] [--overwrite] **Options** +- `--quantization `: Quantization level to download for the model. You can find available quantization levels for each model in the [LEAP Model Library](https://leap.liquid.ai/models). Defaults to `Q5_K_M` if not specified. - `--output-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 ouptut path, the command will throw an error. With this flag, the existing file will be overwritten. @@ -672,27 +673,27 @@ leap-bundle download [--output-path ] [--overwrite] - 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 manifest to use relative paths to the downloaded files. +- Update the local manifest to use relative paths to the downloaded files. - **Does not require authentication** - works immediately after installation **Examples** ```sh # Download from manifest URL (auto-generates directory name) -leap-bundle download https://huggingface.co/LiquidAI/LeapBundles/blob/main/LFM2-Audio-1.5B-GGUF/F16.json +leap-bundle download LFM2-1.2B --quantization Q5_K_M # Example output - -``` -ℹ Downloading manifest from URL... -✓ Manifest downloaded successfully -ℹ Downloading model files... -Downloading model file 1/3... ✓ -Downloading model file 2/3... ✓ -Downloading model file 3/3... ✓ -✓ All files downloaded successfully -ℹ Updating manifest with relative paths... -✓ Download completed successfully! Files saved to: LFM2-Audio-1.5B-GGUF-F16/ +ℹ Verifying URL returns JSON content... +ℹ No output path specified, using: +ℹ Downloading manifest from https://huggingface.co/LiquidAI/LeapBundles/resolve/main/LFM2-1.2B-GGUF/Q5_K_M.json... +⠙ Downloading manifest completed! +✓ Manifest downloaded to /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: /Q5_K_M.json +✓ All files downloaded successfully to: ``` **Manifest Format** From 43972d642fbccff918a701aee5842b83384bdbf6 Mon Sep 17 00:00:00 2001 From: Darian Bhathena Date: Tue, 16 Dec 2025 16:45:23 -0500 Subject: [PATCH 2/4] update quick start --- leap/leap-bundle/quick-start.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/leap/leap-bundle/quick-start.mdx b/leap/leap-bundle/quick-start.mdx index d30bae3..24f5ab3 100644 --- a/leap/leap-bundle/quick-start.mdx +++ b/leap/leap-bundle/quick-start.mdx @@ -25,20 +25,20 @@ pip install leap-bundle ## Quick Start for GGUF Model Download ```sh -leap-bundle download +leap-bundle download [--quantization ] ``` -Example with a HuggingFace URL: +Example: ```sh -leap-bundle download https://huggingface.co/LiquidAI/LeapBundles/blob/main/LFM2-Audio-1.5B-GGUF/F16.json +leap-bundle download LFM2-1.2B --quantization Q5_K_M ``` The command will: 1. Create an output directory based on the URL or according to `--output-path` if specified. -2. Download the JSON manifest file. +2. Download the JSON manifest file for the given combination of model and quantization, if it exists. 3. Download all model files referenced in the manifest. -4. Update the manifest to use relative paths to the downloaded files. +4. Update the local manifest to use relative paths to the downloaded files. :::tip Manifest downloads don't require authentication with `leap-bundle login`. They work immediately after installation. From 4a25c29c38ee3b53256fac036bcb6467bf003aca Mon Sep 17 00:00:00 2001 From: Darian Bhathena Date: Tue, 16 Dec 2025 16:47:57 -0500 Subject: [PATCH 3/4] changelog --- leap/leap-bundle/changelog.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/leap/leap-bundle/changelog.md b/leap/leap-bundle/changelog.md index 125dd34..1775a1a 100644 --- a/leap/leap-bundle/changelog.md +++ b/leap/leap-bundle/changelog.md @@ -4,6 +4,12 @@ sidebar_position: 4 # Changelog +## `v0.8.0` - 2025-12-16 + +**Improvements** + +- Update GGUF model download interface to take model name and quantization rather than manifest URL directly. + ## `v0.7.0` - 2025-11-19 **New features** From f8cbc431afcb866f1859cc53544ec8d25e04eeb3 Mon Sep 17 00:00:00 2001 From: Darian Bhathena Date: Tue, 16 Dec 2025 16:58:12 -0500 Subject: [PATCH 4/4] update command behavior --- leap/leap-bundle/quick-start.mdx | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/leap/leap-bundle/quick-start.mdx b/leap/leap-bundle/quick-start.mdx index 24f5ab3..bb97d6f 100644 --- a/leap/leap-bundle/quick-start.mdx +++ b/leap/leap-bundle/quick-start.mdx @@ -35,10 +35,11 @@ leap-bundle download LFM2-1.2B --quantization Q5_K_M ``` The command will: -1. Create an output directory based on the URL or according to `--output-path` if specified. -2. Download the JSON manifest file for the given combination of model and quantization, if it exists. -3. Download all model files referenced in the manifest. -4. Update the local manifest to use relative paths to the downloaded files. +1. Resolve the appropriate manifest URL for the model/quantization. +2. Create an output directory based on the URL or according to `--output-path` if specified. +3. Download the JSON manifest file for the given combination of model and quantization, if it exists. +4. Download all model files referenced in the manifest. +5. Update the local manifest to use relative paths to the downloaded files. :::tip Manifest downloads don't require authentication with `leap-bundle login`. They work immediately after installation.