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** 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** diff --git a/leap/leap-bundle/quick-start.mdx b/leap/leap-bundle/quick-start.mdx index d30bae3..bb97d6f 100644 --- a/leap/leap-bundle/quick-start.mdx +++ b/leap/leap-bundle/quick-start.mdx @@ -25,20 +25,21 @@ 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. -3. Download all model files referenced in the manifest. -4. Update the 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.