# میرور Hugging Face ( مدل ML، دانلود مدل ) در ایران

Canonical: https://mirror.rasanegaar.com/guides/hf.html
Language: fa

میرور Hugging Face برای دانلود مدل ML، dataset و transformer از ایران — mirror.rasanegaar.com/hf/

میرور Hugging Face (مدل ML، دانلود مدل) — دانلود مدل و دیتاست Hugging Face از ایران — با huggingface_hub و transformers همان کلاینت‌های رسمی را به mirror.rasanegaar.com/hf/ وصل کنید.

## About

Hugging Face میزبان مدل‌ها، توکنایزرها و دیتاست‌های یادگیری ماشین است؛ فایل‌ها اغلب چند گیگابایت‌اند.
میرور رسانگار همان API را در ایران در دسترس می‌گذارد — با کلاینت‌های رسمی مثل huggingface_hub و transformers.

## Mirror in Iran

اندپوینت: `https://mirror.rasanegaar.com/hf/` — همان مسیر روی `repository.rasanegaar.com/hf/`.
فرم جداگانهٔ «درخواست مدل» وجود ندارد: هر دانلود موفق با CLI همان مدل را در کش قرار می‌دهد.
صفحهٔ فرود: `/repos/hf/`.

Browse URL: https://mirror.rasanegaar.com/hf/

## Configuration

1. پکیج را نصب کنید:
pip install -U huggingface_hub
2. متغیرهای محیطی را تنظیم کنید (در `~/.bashrc` یا قبل از هر دستور):
export HF_ENDPOINT=https://mirror.rasanegaar.com/hf
export HF_HUB_ETAG_TIMEOUT=86400
export HF_HUB_DOWNLOAD_TIMEOUT=86400
3. یک مدل عمومی را دانلود کنید:
huggingface-cli download google-bert/bert-base-uncased
4. مدل‌های gated (مثلاً Llama) به توکن نیاز دارند — توکن Hugging Face خود را بگذارید:
export HF_TOKEN=
5. در Python / `transformers` قبل از import:
import os
os.environ.setdefault("HF_ENDPOINT", "https://mirror.rasanegaar.com/hf")
from transformers import AutoModel, AutoTokenizer
6. بررسی اتصال:
curl -s "https://mirror.rasanegaar.com/hf/api/models/google-bert/bert-base-uncased" | head

## Updates

**Ollama** مستقیماً از این اندپوینت به‌عنوان منبع دانلود استفاده نمی‌کند. فایل GGUF را با `huggingface-cli` از میرور بگیرید، سپس با `ollama create` از مسیر محلی import کنید.
**LM Studio** در رابط گرافیکی معمولاً `HF_ENDPOINT` را نادیده می‌گیرد. مدل را با CLI دانلود کنید و در LM Studio از پوشهٔ محلی باز کنید.
هر دانلود موفق با CLI همان مدل را برای درخواست‌های بعدی در دسترس می‌گذارد.

## Related

Registry landing: https://mirror.rasanegaar.com/repos/hf/
Guide HTML: https://mirror.rasanegaar.com/guides/hf.html