Hub Python Library documentation
Managing collections
You are viewing main version, which requires installation from source. If you'd like
regular pip install, checkout the latest stable version (v1.12.1).
Managing collections
Check out the HfApi documentation page for the reference of methods to manage your Space on the Hub.
- Get collection content: get_collection()
- Create new collection: create_collection()
- Update a collection: update_collection_metadata()
- Delete a collection: delete_collection()
- Add an item to a collection: add_collection_item()
- Update an item in a collection: update_collection_item()
- Remove an item from a collection: delete_collection_item()
Collection
class huggingface_hub.Collection
< source >( **kwargs )
Parameters
- slug (
str) — Slug of the collection. E.g."TheBloke/recent-models-64f9a55bb3115b4f513ec026". - title (
str) — Title of the collection. E.g."Recent models". - owner (
str) — Owner of the collection. E.g."TheBloke". - items (
list[CollectionItem]) — List of items in the collection. - last_updated (
datetime) — Date of the last update of the collection. - position (
int) — Position of the collection in the list of collections of the owner. - private (
bool) — Whether the collection is private or not. - theme (
str) — Theme of the collection. E.g."green". - upvotes (
int) — Number of upvotes of the collection. - description (
str, optional) — Description of the collection, as plain text. - url (
str) — (property) URL of the collection on the Hub.
Contains information about a Collection on the Hub.
CollectionItem
class huggingface_hub.CollectionItem
< source >( _id: str id: str type: CollectionItemType_T position: int note: dict | None = None **kwargs )
Parameters
- item_object_id (
str) — Unique ID of the item in the collection. - item_id (
str) — ID of the underlying object on the Hub. Can be either a repo_id, a paper id, a collection slug or a bucket id. e.g."jbilcke-hf/ai-comic-factory","2307.09288","celinah/cerebras-function-calling-682607169c35fbfa98b30b9a". - item_type (
str) — Type of the underlying object. Can be one of"model","dataset","space","paper","collection"or"bucket". - position (
int) — Position of the item in the collection. - note (
str, optional) — Note associated with the item, as plain text.
Contains information about an item of a Collection (model, dataset, Space, paper, collection or bucket).