Update README.md

Browse files

Files changed (1) hide show

README.md +49 -105

README.md CHANGED Viewed

@@ -1,121 +1,65 @@
-# HuggingFaceDownloader 2.2.1
-**A free, portable downloader for Hugging Face models and files on Windows.**
-Скачивайте модели и большие файлы с Hugging Face без установки программы. HuggingFaceDownloader помогает продолжать прерванные загрузки, проверяет целостность файлов и автоматически регулирует нагрузку на диск, чтобы компьютером было удобнее пользоваться во время скачивания.
-**Версия:** 2.2.1
-**Дата выпуска:** 26 октября 2026 года
-**Платформа:** Windows 10 / 11 (64-bit)
-**Размер:** около 152 МБ
-**Установка:** не требуется
 ---
-## Screenshots
-Добавьте сюда скриншоты интерфейса программы после загрузки изображений в репозиторий.
-<!-- Replace these examples with your actual screenshot filenames -->
-<!-- ![Main window](screenshots/main-window.png) -->
 ---
-## Features
-### 💽 Automatic disk load management
-При скачивании файлов размером в десятки гигабайт диск может оказаться перегружен, из-за чего Windows начинает тормозить.
-HuggingFaceDownloader автоматически регулирует скорость записи, стараясь удерживать загрузку диска около заданного уровня. Когда диск занят другими задачами, программа снижает скорость записи.
-Это помогает уменьшить зависания и оставляет системе больше ресурсов для других приложений. Реальный результат зависит от типа диска и общей нагрузки на компьютер.
-### 🔄 Resume interrupted downloads
-Если интернет пропал или загрузка завершилась с ошибкой, частично скачанный файл сохраняется.
-При следующем запуске программа может продолжить скачивание с сохранённого места, а не загружать всё заново.
-Это особенно полезно для больших моделей, которые могут скачиваться часами.
-### 🛡️ File integrity verification
-После скачивания программа проверяет целостность файла с помощью SHA-256.
-- Исправный файл принимается.
-- Незавершённая загрузка сохраняется для продолжения.
-- Повреждённый файл полного размера удаляется, чтобы его можно было скачать заново.
-Если контрольная сумма совпадает, файл принимается даже в том случае, когда размер, указанный API Hugging Face, отличается от фактического.
-### 🌐 Handling network errors
-При временных сетевых сбоях программа повторяет попытки с постепенно увеличивающимися паузами — от 2 до 15 секунд.
-Если очередная попытка успешно получает новые данные, счётчик сетевых ошибок сбрасывается. Это помогает избежать преждевременного прекращения длительных загрузок.
-Для моделей с ограниченным доступом предусмотрена обработка ошибок авторизации и повторная попытка после неё.
-### 📊 Accurate download results
-В конце загрузки программа отдельно учитывает файлы, добавленные в очередь, и файлы, которые действительно скачаны до конца.
-Пропущенные или отменённые файлы больше не должны ошибочно отображаться как успешно загруженные.
-### ⚙️ Configurable settings
-Поведение программы можно настраивать через `settings.json`.
-Доступны параметры управления нагрузкой на диск, целевого у��овня занятости диска, ограничения скорости записи и ведения журналов.
-Журналирование по умолчанию отключено, чтобы не создавать лишние файлы и не выполнять ненужную запись на диск.
----
-## What's new in version 2.2.1
-**Главное в обновлении:** более бережная запись на диск, сохранение незавершённых загрузок и улучшенная проверка файлов.
-- Добавлен автоматический контроллер нагрузки на диск.
-- Улучшена запись данных, чтобы уменьшить резкие скачки дисковой активности.
-- Добавлено сохранение частично скачанных файлов при неудачных попытках.
-- Улучшено восстановление загрузок после сетевых сбоев.
-- Изменена логика проверки SHA-256 и обработки файлов с неправильным размером.
-- Улучшена обработка повторных попыток при сетевых ошибках.
-- Исправлен подсчёт успешно завершённых загрузок.
-- Количество автоматических тестовых сценариев увеличено со 136 до 141.
-### Important notes
-- Если диск одновременно активно используют другие программы, загрузка может замедляться.
-- Для медленных USB-накопителей можно установить ограничение скорости записи, например 20 МБ/с.
-- Существующий `settings.json` автоматически не обновляется. Старые параметры при необходимости нужно изменить вручную.
-- При первом запуске portable-версии служебные компоненты распаковываются во временную папку Windows. Необходим доступ на запись в `%TEMP%`.
-- При выключенном журналировании подробные сообщения о регулировке дисковой нагрузки не сохраняются.
----
 ## Download
-**[Download HuggingFaceDownloader.exe](./HuggingFaceDownloader.exe)**
-Скачайте EXE-файл и запустите его. Устанавливать программу не нужно.
-**Системные требования:** Windows 10 или Windows 11, 64-разрядная версия.
----
-## Build information
-- Version: `2.2.1.0`
-- Framework: `.NET 10`
-- Build type: portable single-file
-- Architecture: `win-x64`
-- Automated tests: `141/141`
-- Build result: 0 errors, 0 warnings
----
-HuggingFaceDownloader создан для удобного скачивания моделей и файлов с Hugging Face. Основное внимание уделено надёжности загрузок, сохранению уже полученных данных и снижению влияния скачивания больших файлов на работу компьютера.

 ---
+title: HuggingFaceDownloader
+emoji: 📥
+colorFrom: blue
+colorTo: green
+tags:
+  - windows
+  - downloader
+  - hugging-face
+  - portable
+  - csharp
+  - wpf
+  - model-downloader
+  - dataset-downloader
 ---
+# HuggingFaceDownloader 2.2.1
+**A free, portable Windows downloader for Hugging Face models, datasets, and repository files.**
+HuggingFaceDownloader is a free, self-contained Windows application built with C# and WPF. It provides a graphical interface for browsing Hugging Face repositories, selecting individual files, and downloading large files without using the command line.
+The application supports resuming interrupted downloads, SHA-256 integrity verification, and automatic disk write throttling to help keep Windows responsive during large downloads.
+## Search keywords
+Hugging Face Downloader, HuggingFace Downloader, Hugging Face download tool, Windows downloader, portable Hugging Face downloader, Hugging Face model downloader, AI model downloader, LLM downloader, dataset downloader, GGUF downloader, safetensors downloader, C# downloader, WPF application, resume downloads, SHA-256 verification.
+## Features
+- 🪟 Windows 10 / 11 (64-bit)
+- 📦 Portable single-file application — no installation required
+- 🤖 Download AI models and files from Hugging Face
+- 📂 Browse repositories and select individual files
+- 🔄 Resume interrupted downloads
+- 🛡️ Verify downloaded files using SHA-256
+- 💽 Automatically regulate disk write load
+- 🌐 Handle repositories requiring authorization
 ## Download
+[Download HuggingFaceDownloader.exe](./HuggingFaceDownloader.exe)
+**Version:** 2.2.1
+**Release date:** October 26, 2026
+**Size:** approximately 152 MB
+**Requirements:** Windows 10/11 x64
+## What's new in version 2.2.1
+- Added automatic disk write throttling.
+- Improved handling of large downloads.
+- Preserved partially downloaded files for resuming.
+- Improved retry handling for network interruptions.
+- Improved SHA-256 integrity verification.
+- Improved reporting of completed downloads.
+- Expanded automated tests to 141 cases.
+## Technology
+- C#
+- WPF
+- .NET 10
+- Windows x64
+- Portable single-file distribution