# Instalasi

Sebelum memulai, Anda perlu menyiapkan lingkungan dengan menginstal paket yang sesuai.

`huggingface_hub` diuji pada **Python 3.10+**.

## Install dengan pip

Sangat disarankan untuk menginstal `huggingface_hub` dalam [lingkungan virtual](https://docs.python.org/3/library/venv.html). Jika Anda belum familiar dengan lingkungan virtual Python, silakan lihat [panduan](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/) ini. Lingkungan virtual memudahkan pengelolaan proyek yang berbeda dan menghindari masalah kompatibilitas antar dependensi.

Mulai dengan membuat lingkungan virtual di direktori proyek Anda:

```bash
python -m venv .venv
```

Aktifkan lingkungan virtual. Di Linux dan macOS:

```bash
source .venv/bin/activate
```

Aktifkan lingkungan virtual di Windows:

```bash
.venv/Scripts/activate
```

Sekarang Anda siap menginstal `huggingface_hub` [dari registry PyPi](https://pypi.org/project/huggingface-hub/):

```bash
pip install --upgrade huggingface_hub
```

Setelah selesai, [periksa instalasi](#check-installation) berfungsi dengan benar.

### Instal dependensi opsional

Beberapa dependensi dari `huggingface_hub` bersifat [opsional](https://setuptools.pypa.io/en/latest/userguide/dependency_management.html#optional-dependencies) karena tidak diperlukan untuk menjalankan fitur inti dari `huggingface_hub`. Namun, beberapa fitur dari `huggingface_hub` mungkin tidak tersedia jika dependensi opsional tersebut tidak diinstal.

Anda dapat menginstal dependensi opsional melalui `pip`:
```bash
# Install dependencies for both torch-specific and MCP-specific features.
pip install 'huggingface_hub[mcp,torch]'
```

Berikut adalah daftar dependensi opsional di `huggingface_hub`:
- `fastai`, `torch`: dependensi untuk menjalankan fitur yang spesifik pada framework.
- `dev`: dependensi untuk berkontribusi pada lib. Termasuk `testing` (untuk menjalankan tes), `typing` (untuk menjalankan type checker) dan `quality` (untuk menjalankan linter).

### Instal dari sumber

Dalam beberapa kasus, menarik untuk menginstal `huggingface_hub` langsung dari sumber. Hal ini memungkinkan Anda menggunakan versi `main` terbaru (bleeding edge) alih-alih versi stabil terbaru. Versi `main` berguna untuk tetap mengikuti perkembangan terkini, misalnya jika sebuah bug telah diperbaiki sejak rilis resmi terakhir tetapi rilis baru belum diterbitkan.

Namun, ini berarti versi `main` mungkin tidak selalu stabil. Kami berusaha menjaga versi `main` tetap berfungsi, dan sebagian besar masalah biasanya diselesaikan dalam beberapa jam atau satu hari. Jika Anda menemui masalah, silakan buka Issue agar kami dapat memperbaikinya lebih cepat!

```bash
pip install git+https://github.com/huggingface/huggingface_hub
```

Saat menginstal dari sumber, Anda juga dapat menentukan cabang tertentu. Ini berguna jika Anda ingin menguji fitur baru atau perbaikan bug baru yang belum digabungkan:

```bash
pip install git+https://github.com/huggingface/huggingface_hub@my-feature-branch
```

Setelah selesai, [periksa instalasi](#check-installation) berfungsi dengan benar.

### Instalasi yang dapat diedit

Menginstal dari sumber memungkinkan Anda untuk mengatur [instalasi yang dapat diedit](https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs). Ini adalah instalasi yang lebih lanjut jika Anda berencana berkontribusi pada `huggingface_hub` dan perlu menguji perubahan dalam kode. Anda perlu mengkloning salinan lokal `huggingface_hub` di mesin Anda.

```bash
# First, clone repo locally
git clone https://github.com/huggingface/huggingface_hub.git

# Then, install with -e flag
cd huggingface_hub
pip install -e .
```

Perintah ini akan menghubungkan folder tempat Anda mengkloning repositori dengan jalur pustaka Python Anda. Python kini akan mencari di dalam folder yang Anda kloning selain jalur pustaka standar. Misalnya, jika paket Python Anda biasanya diinstal di `./.venv/lib/python3.13/site-packages/`, Python juga akan mencari folder yang Anda kloning `./huggingface_hub/`.

## Install CLI Hugging Face 

Gunakan installer satu baris kami untuk mengatur CLI `hf` tanpa menyentuh lingkungan Python Anda:

Pada macOS dan Linux:

```bash
curl -LsSf https://hf.co/cli/install.sh | bash
```

Di Windows:

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"
```

Untuk memperbarui instalasi yang sudah ada, jalankan `hf update` — perintah ini mendeteksi bagaimana `hf` diinstal (installer mandiri, Homebrew, atau pip) dan menjalankan perintah yang sesuai.

## Instal dengan conda

Jika Anda lebih terbiasa dengannya, Anda dapat menginstal `huggingface_hub` menggunakan [kanal conda-forge](https://anaconda.org/conda-forge/huggingface_hub):

```bash
conda install -c conda-forge huggingface_hub
```

Setelah selesai, [periksa instalasi](#check-installation) berfungsi dengan benar.

## Periksa instalasi

Setelah terinstal, periksa apakah `huggingface_hub` berfungsi dengan baik dengan menjalankan perintah berikut:

```bash
python -c "from huggingface_hub import model_info; print(model_info('gpt2'))"
```

Perintah ini akan mengambil informasi dari Hub tentang model [gpt2](https://huggingface.co/gpt2). Output seharusnya terlihat seperti ini:

```text
Model Name: gpt2
Tags: ['pytorch', 'tf', 'jax', 'tflite', 'rust', 'safetensors', 'gpt2', 'text-generation', 'en', 'doi:10.57967/hf/0039', 'transformers', 'exbert', 'license:mit', 'has_space']
Task: text-generation
```

## Batasan Windows

Dengan tujuan kami untuk mendemokratisasi ML yang baik di mana saja, kami membangun `huggingface_hub` sebagai pustaka lintas platform, dan khususnya agar berfungsi dengan benar di sistem berbasis Unix maupun Windows. Namun, ada beberapa kasus di mana `huggingface_hub` memiliki keterbatasan saat dijalankan di Windows. Berikut adalah daftar lengkap masalah yang diketahui. Silakan beri tahu kami jika Anda menemui masalah yang tidak terdokumentasi dengan membuka [isu di Github](https://github.com/huggingface/huggingface_hub/issues/new/choose).

- Sistem cache `huggingface_hub` mengandalkan symlink untuk meng-cache file yang diunduh secara efisien
dari Hub. Di Windows, Anda harus mengaktifkan mode developer atau menjalankan skrip Anda sebagai admin untuk mengaktifkan symlink. Jika tidak diaktifkan, sistem cache tetap berfungsi tetapi dengan cara yang tidak dioptimalkan. Silakan baca bagian [batasan cache](./guides/manage-cache#limitations) untuk detail lebih lanjut.
- Filepath di Hub dapat memiliki karakter khusus (misalnya `"path/to?/my/file"`). Windows
lebih restriktif terhadap [karakter khusus](https://learn.microsoft.com/en-us/windows/win32/intl/character-sets-used-in-file-names) yang membuat unduhan file tersebut tidak mungkin dilakukan di Windows. Semoga ini adalah kasus yang jarang terjadi. Silakan hubungi pemilik repositori jika Anda merasa ini adalah kesalahan, atau hubungi kami untuk mencari solusi.

## Langkah selanjutnya

Setelah `huggingface_hub` terpasang dengan benar di mesin Anda, Anda mungkin ingin [mengonfigurasi variabel lingkungan](package_reference/environment_variables) atau [memeriksa salah satu panduan kami](guides/overview) untuk memulai.

