2.3.1 Minor Updates and Fixes

Author: bodaay

README.md

@@ -162,6 +162,24 @@ cd HuggingFaceModelDownloader
 go build -o hfdownloader ./cmd/hfdownloader
 ```
 
+### Option 4: Docker 🐳
+
+```bash
+# Build the image
+docker build -t hfdownloader .
+
+# Run CLI in container
+docker run --rm -v ./models:/data hfdownloader download TheBloke/Mistral-7B-GGUF -o /data
+
+# Run web server
+docker run --rm -p 8080:8080 -v ./models:/data hfdownloader serve \
+  --models-dir /data/Models \
+  --datasets-dir /data/Datasets
+
+# With HuggingFace token
+docker run --rm -e HF_TOKEN=hf_xxx -p 8080:8080 hfdownloader serve
+```
+
 ---
 
 ## 🌐 Web UI
@@ -188,7 +206,8 @@ hfdownloader serve \
   --port 3000 \
   --models-dir ./Models \
   --datasets-dir ./Datasets \
-  --token hf_xxx
+  --token hf_xxx \
+  --endpoint https://hf-mirror.com  # Optional: use mirror
 ```
 
 ---
@@ -222,6 +241,12 @@ export HF_TOKEN=hf_xxxxx
 # Filter specific files (case-insensitive)
 hfdownloader download TheBloke/Mistral-7B-GGUF:q4_k_m,q5_k_m
 
+# Exclude files by pattern
+hfdownloader download TheBloke/Mistral-7B-GGUF -E .md,fp16,onnx
+
+# Combine filters and excludes
+hfdownloader download owner/repo -F q4_k_m,q5_k_m -E .md
+
 # Organize filtered files into subdirs
 hfdownloader download TheBloke/Mistral-7B-GGUF:q4_0,q8_0 --append-filter-subdir
 # Result: ./Storage/Mistral-7B-GGUF/q4_0/file.gguf
@@ -235,6 +260,9 @@ hfdownloader download owner/repo -b v1.0
 
 # Dry run (preview files)
 hfdownloader download owner/repo --dry-run --plan-format json
+
+# Use HuggingFace mirror (e.g., for China)
+hfdownloader download owner/repo --endpoint https://hf-mirror.com
 ```
 
 ### Flags Reference
@@ -258,6 +286,7 @@ hfdownloader download owner/repo --dry-run --plan-format json
 | `--dataset` | `false` | Treat as dataset |
 | `-b, --revision` | `main` | Branch, tag, or commit |
 | `-F, --filters` | - | Comma-separated LFS filters |
+| `-E, --exclude` | - | Comma-separated patterns to exclude |
 
 </details>
 
@@ -291,6 +320,7 @@ hfdownloader download owner/repo --dry-run --plan-format json
 |------|---------|-------------|
 | `-t, --token` | `$HF_TOKEN` | HuggingFace access token |
 | `--config` | `~/.config/hfdownloader.yaml` | Config file path |
+| `--endpoint` | `https://huggingface.co` | Custom HF endpoint (mirrors) |
 
 </details>
 

RELEASE_NOTES.md

@@ -55,6 +55,25 @@ docker run --rm -p 8080:8080 -v ./models:/data hfdownloader serve --models-dir /
 - Created `Dockerfile` with multi-stage build
 - Updated API to support `excludes` in download requests
 - Updated settings endpoint to include custom endpoint config
+- **Web UI:** Added "Exclude" input field to Model and Dataset download forms
+- **Web UI:** Updated version display to v2.3.1
+
+---
+
+## 🙏 Acknowledgments
+
+Special thanks to the community members whose PRs inspired these features:
+
+| Contributor | PR | Feature |
+|-------------|-----|---------|
+| **[@jeroenkroese](https://github.com/jeroenkroese)** | [#41](https://github.com/bodaay/HuggingFaceModelDownloader/pull/41) | Exclude file patterns |
+| **[@windtail](https://github.com/windtail)** | [#38](https://github.com/bodaay/HuggingFaceModelDownloader/pull/38) | Custom HuggingFace endpoint |
+| **[@cdeving](https://github.com/cdeving)** | [#50](https://github.com/bodaay/HuggingFaceModelDownloader/pull/50) | Docker support |
+
+Also thanks to the community for bug reports and PRs that helped identify issues in v2.3.0:
+- URL escaping fix (related to #60)
+- TUI speed improvements (related to #59)
+- API 400 fixes (related to #58)
 
 ---
 
@@ -196,15 +215,6 @@ go build -o hfdownloader ./cmd/hfdownloader
 
 ---
 
-## 🙏 Acknowledgments
-
-Thanks to the community for bug reports and PRs that helped identify issues:
-- URL escaping fix (related to #60)
-- TUI speed improvements (related to #59)
-- API 400 fixes (related to #58)
-
----
-
 ## 📋 Full Changelog
 
 **New Files:**

internal/assets/static/index.html

@@ -78,7 +78,7 @@
           <span class="status-dot"></span>
           <span class="status-text">Connecting...</span>
         </div>
-        <div class="version">v2.3.0</div>
+        <div class="version">v2.3.1</div>
       </div>
     </nav>
 
@@ -197,6 +197,17 @@ <h1>Download Model</h1>
               <span class="input-hint">Comma-separated. Only downloads LFS files matching these patterns (e.g., quantizations).</span>
             </div>
 
+            <div class="form-group">
+              <label for="modelExcludesInput">Exclude (optional)</label>
+              <input 
+                type="text" 
+                id="modelExcludesInput" 
+                name="excludes" 
+                placeholder=".md, fp16, onnx"
+              >
+              <span class="input-hint">Comma-separated. Skip files matching these patterns.</span>
+            </div>
+
             <div class="form-group">
               <label class="checkbox-label">
                 <input type="checkbox" id="modelFilterSubdirCheck" name="appendFilterSubdir">
@@ -280,6 +291,17 @@ <h1>Download Dataset</h1>
               <span class="input-hint">Comma-separated. Filter LFS files by name pattern.</span>
             </div>
 
+            <div class="form-group">
+              <label for="datasetExcludesInput">Exclude (optional)</label>
+              <input 
+                type="text" 
+                id="datasetExcludesInput" 
+                name="excludes" 
+                placeholder=".md, .txt, raw"
+              >
+              <span class="input-hint">Comma-separated. Skip files matching these patterns.</span>
+            </div>
+
             <div class="form-actions">
               <button type="button" class="btn btn-ghost btn-preview" data-form="datasetForm">
                 <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" width="16" height="16">

internal/assets/static/js/app.js

@@ -845,6 +845,11 @@
     formData.forEach((value, key) => {
       if (key === 'dataset' || key === 'appendFilterSubdir') {
         obj[key] = true;
+      } else if (key === 'filters' || key === 'excludes') {
+        // Convert comma-separated string to array
+        if (value && value.trim()) {
+          obj[key] = value.split(',').map(s => s.trim()).filter(s => s);
+        }
       } else if (value) {
         obj[key] = value;
       }