File size: 3,380 Bytes
73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 55f2099 aed618a 55f2099 73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 73e3842 aed618a 73e3842 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 | # Hub search: URLs and Python
This guide shows how to search models using **URL parameters** and the **Python library** (`huggingface_hub`). Use it to find repos by tag, author (user or org), and more.
---
## 1. Search by URL
You can build URLs that pre-fill the Hub search.
### Main parameters
| Parameter | Meaning | Example |
|------------|-----------------------------------------------|----------------------------------|
| `other` | Tags (comma-separated for multiple) | `other=hunyuan` or `other=hunyuan,conversational` |
| `author` | User or org that owns the repo | `author=netflix` or `author=tencent-community` |
| `search` | Full-text search in repo name/description | `search=bert` |
### Models
- Base URL: `https://huggingface.co/models`
- Examples:
- All models with tag **hunyuan**:
`https://huggingface.co/models?other=hunyuan`
- Models with **two tags**:
`https://huggingface.co/models?other=hunyuan,conversational`
- Models from an **org** (e.g. tencent-community):
`https://huggingface.co/models?author=tencent-community`
- **Tag + author**:
`https://huggingface.co/models?other=hunyuan,conversational&author=tencent-community`
### Path to your model
---
## 2. Search with Python
The same filters are available in `huggingface_hub` via `list_models`.
For **private** or **gated** repos, use a token (e.g. `token=True` or `token="hf_..."`).
### List models
```python
from huggingface_hub import list_models
# All models from an org (e.g. netflix – use token if private)
for repo in list_models(author="netflix", token=True):
print(repo.id) # e.g. netflix/mdeberta_512_v3_base, netflix/my-bert-model
# By tag
list_models(other="conversational")
# By tag + author
list_models(other="hunyuan,conversational", author="tencent-community")
```
---
## 3. Example: private org "netflix"
If your org has these models:
- **Models:** `netflix/mdeberta_512_v3_base`, `netflix/my-bert-model`
### URLs (logged in)
- All models from netflix:
`https://huggingface.co/models?author=netflix`
### Python (with token for private)
```python
from huggingface_hub import list_models
for m in list_models(author="netflix", token=True):
print(m.id)
# netflix/mdeberta_512_v3_base
# netflix/my-bert-model
```
---
## 4. Discovering tags
- On a **model repo page**, the tags are listed; **clicking a tag** takes you to the models search with that tag in `other`.
- To add and manage tags on your model, see [Model cards](https://huggingface.co/docs/hub/model-cards) (metadata and tags).
---
## 5. Full reference
- **URLs:** Build `https://huggingface.co/models?other=tag1,tag2&author=<namespace>`.
**`author`** is the **namespace**: the org name or username (e.g. `netflix`, `tencent-community`, or a Hub username). Use the same value in URLs and in Python.
- **Python:** [Search guide](https://huggingface.co/docs/huggingface_hub/guides/search) in the docs.
- **Token:** For private/gated repos, use `token=True` (from env or cache) or `token="hf_..."` in Python; for URLs, be logged in on the site.
|