# Hugging Face

Hugging Face Hub: models, datasets, spaces, repos, inference endpoints. Exposes **24 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `huggingface_whoami` | Get authenticated user info - GET /user. |
| `huggingface_models_list` | List models - GET /models. |
| `huggingface_model_get` | Get one model info - GET /models/{repo_id}. |
| `huggingface_model_create` | Create a new model repository - POST /models. |
| `huggingface_model_delete` | Delete a model repository - DELETE /models/{repo_id}. |
| `huggingface_model_update_settings` | Update model settings - PATCH /models/{repo_id}. |
| `huggingface_model_refs` | Get model refs (branches/tags) - GET /models/{repo_id}/refs. |
| `huggingface_model_tree` | List model files (tree) - GET /models/{repo_id}/tree. |
| `huggingface_datasets_list` | List datasets - GET /datasets. |
| `huggingface_dataset_get` | Get one dataset info - GET /datasets/{repo_id}. |
| `huggingface_dataset_create` | Create a new dataset repository - POST /datasets. |
| `huggingface_dataset_delete` | Delete a dataset repository - DELETE /datasets/{repo_id}. |
| `huggingface_dataset_tree` | List dataset files (tree) - GET /datasets/{repo_id}/tree. |
| `huggingface_spaces_list` | List spaces - GET /spaces. |
| `huggingface_space_get` | Get one space info - GET /spaces/{repo_id}. |
| `huggingface_likes_list` | List user's liked models - GET /user/likes. |
| `huggingface_like_model` | Like a model - POST /user/likes/{repo_id}. |
| `huggingface_unlike_model` | Unlike a model - DELETE /user/likes/{repo_id}. |
| `huggingface_model_commits_list` | List model commits - GET /models/{repo_id}/commits. |
| `huggingface_dataset_commits_list` | List dataset commits - GET /datasets/{repo_id}/commits. |
| `huggingface_repo_move` | Move/rename a repository - POST /repos/move. |
| `huggingface_org_members_list` | List organization members - GET /organizations/{org}/members. |
| `huggingface_inference_endpoints_list` | List inference endpoints - GET /endpoints. |
| `huggingface_inference_endpoint_get` | Get inference endpoint details - GET /endpoints/{endpoint_name}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`HUGGINGFACE_TOKEN`** - Hugging Face - Settings - Access Tokens (hf_...). (https://huggingface.co/settings/tokens)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `HUGGINGFACE_TOKEN` | Hugging Face - Settings - Access Tokens (hf_...). |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Hugging Face API documentation](https://huggingface.co/docs/hub/api)