For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hugging Face

Your Toolhouse AI Worker can connect to Hugging Face using 135 specialized tools.

Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.

Tools (135)

Hugging Face Change Discussions Status

Integration name: HUGGING_FACE_CHANGE_DISCUSSIONS_STATUS

Tool to change the status of a Hugging Face repository discussion. Use when you need to open or close discussions on models, datasets, or spaces.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

num

string

"1"

The discussion number or ID to change the status of. This is the numeric identifier of the discussion thread.

repo

string

"bert-base-uncased"

The repository name where the discussion exists. For example, 'bert-base-uncased' or 'my-dataset'.

status

string

"closed"

The new status to set for the discussion. Use 'open' to reopen a closed discussion or 'closed' to close an open discussion.

comment

string

"Closing this as resolved."

Optional comment to add when changing the status. Useful for explaining why the discussion is being closed or reopened.

namespace

string

"google-bert"

The namespace (username or organization) that owns the repository. For example, 'google-bert' or 'huggingface'.

repo_type

string

"models"

The type of repository where the discussion exists. Must be one of: models, spaces, or datasets.


Hugging Face Check Dataset Validity

Integration name: HUGGING_FACE_CHECK_DATASET_VALIDITY

Tool to check whether a specific dataset is valid on Hugging Face Hub. Use when you need to determine what features (preview, viewer, search, filter, statistics) are available for a dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

dataset

string

"rajpurkar/squad"

Name of the dataset to check validity for. Format: 'namespace/repo-name' (e.g., 'rajpurkar/squad', 'huggingface/cifar10').


Hugging Face Check Models Upload Method

Integration name: HUGGING_FACE_CHECK_MODELS_UPLOAD_METHOD

Tool to check if files should be uploaded through the Large File mechanism or directly. Use when preparing to upload files to a Hugging Face model repository to determine the appropriate upload method for each file.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit hash) to upload to.

repo

string

"bert-base-uncased"

The name of the model repository.

files

array

List of files to check for upload method. Maximum 1000 files.

gitIgnore

string

Content of the .gitignore file for the revision. Optional, otherwise uses existing .gitignore content.

namespace

string

"google-bert"

The namespace (user or organization) that owns the model repository.

gitAttributes

string

Content of the .gitattributes file. Provide this if you plan to modify .gitattributes yourself when uploading LFS files. Not needed if relying on automatic LFS detection.


Hugging Face Check Spaces Upload Method

Integration name: HUGGING_FACE_CHECK_SPACES_UPLOAD_METHOD

Tool to check if files should be uploaded through the Large File mechanism or directly to Hugging Face Spaces. Use when preparing to upload files to a Hugging Face Space repository to determine the appropriate upload method for each file.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit hash) to upload to.

repo

string

"test-branch-space"

The name of the Space repository.

files

array

List of files to check for upload method. Maximum 1000 files.

gitIgnore

string

Content of the .gitignore file for the revision. Optional, otherwise uses existing .gitignore content.

namespace

string

"121tester"

The namespace (user or organization) that owns the Space repository.

gitAttributes

string

Content of the .gitattributes file. Provide this if you plan to modify .gitattributes yourself when uploading LFS files. Not needed if relying on automatic LFS detection.


Hugging Face Claim Settings Papers Claim

Integration name: HUGGING_FACE_CLAIM_SETTINGS_PAPERS_CLAIM

Tool to claim authorship of a paper on Hugging Face. Use when you need to associate yourself or another user with an ArXiv paper.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

paper_id

string

"2501.12345"

ArXiv paper identifier being claimed. This should be the ArXiv ID of the paper you want to claim authorship for.

target_user_id

string

"507f1f77bcf86cd799439012"

HF user who should receive the claim. Must be a 24-character hexadecimal string representing the Hugging Face user ID. Only provide this if you need to assign the claim to a specific user.

claim_author_id

string

"507f1f77bcf86cd799439011"

Author entry on the paper being claimed. Must be a 24-character hexadecimal string representing the specific author entry on the paper. Only provide this if you need to specify a particular author entry.


Hugging Face Create Ask Access

Integration name: HUGGING_FACE_CREATE_ASK_ACCESS

Tool to request access to a gated repository on Hugging Face Hub. Use when you need to submit an access request for models, datasets, or Spaces that require approval. The fields required vary by repository.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"Llama-3.3-70B-Instruct"

The repository name of the gated model, dataset, or Space.

namespace

string

"meta-llama"

The namespace (organization or user) that owns the gated repository.

repo_type

string

The type of repository (models, datasets, or spaces). Defaults to models.

access_request_fields

object

{"Country":"US","Job title":"AI researcher","Last Name":"Doe","First Name":"John","Affiliation":"University of Example","Date of birth":"1990-01-01","By clicking Submit below I accept the terms of the license and acknowledge that the information I provide will be collected stored processed and shared in accordance with the Meta Privacy Policy":"I accept"}

A dictionary of field names and values required by the repository's access form. Common fields include "First Name", "Last Name", "Date of birth" (YYYY-MM-DD format), "Country" (country code), "Affiliation", "Job title", and terms acceptance fields. The exact fields vary by repository and are specified in the repository's gated access configuration.


Hugging Face Create Collection

Integration name: HUGGING_FACE_CREATE_COLLECTION

Tool to create a new collection on Hugging Face. Use when you need to organize and curate models, datasets, spaces, papers, or other collections into a named collection.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

item

object

Item to be added to the collection upon creation.

title

string

"My Awesome Models"

The title of the collection. Must be between 1 and 60 characters.

private

boolean

true

If not provided, the collection will be public. This field will respect the organization's visibility setting.

namespace

string

"johndoe"

The namespace (username or organization) under which to create the collection

description

string

"A curated list of state-of-the-art language models"

Optional description for the collection. Maximum 150 characters.


Hugging Face Create Datasets Branch

Integration name: HUGGING_FACE_CREATE_DATASETS_BRANCH

Tool to create a new branch in a Hugging Face dataset repository. Use when you need to create a branch for versioning or experimentation with dataset changes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The name of the new branch to create.

repo

string

"test-discussion-dataset"

The name of the dataset repository without the namespace prefix.

namespace

string

"121tester"

The namespace (username or organization) that owns the dataset repository.

overwrite

boolean

Overwrite the branch if it already exists. Defaults to false.

emptyBranch

boolean

Create an empty branch without any files. Defaults to false.

startingPoint

string

"main"

The commit hash, tag, or branch name to start the new branch from. Defaults to 'main' if not specified.


Hugging Face Create Datasets Commit

Integration name: HUGGING_FACE_CREATE_DATASETS_COMMIT

Tool to create a commit in a Hugging Face dataset repository. Use when you need to add, update, or delete files in a dataset. Supports both regular files and Large File Storage (LFS) for large binary files. Can optionally create a pull request instead of directly committing.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

Revision (branch name, tag, or commit SHA) to commit to

repo

string

"my-dataset"

Name of the dataset repository

files

array

[{"path":"test.txt","content":"Hello World","encoding":"utf-8"}]

List of files to add or update in the commit. Each file requires a path and either content or oldPath.

summary

string

"Add training data"

Summary of the commit (required). This is the commit message title.

create_pr

string

"1"

Whether to create a pull request from the commit. Set to '1' or 'true' to create a PR.

lfs_files

array

[{"oid":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855","algo":"sha256","path":"models/model.bin","size":1024000}]

List of Large File Storage (LFS) files to include in the commit

namespace

string

"my-username"

Namespace (username or organization) that owns the dataset repository

hot_reload

string

"1"

For Spaces, whether to try to hot reload the commit (only for single Python file updates). Set to '1' or 'true' to enable.

description

string

"Added new training examples from production data"

Detailed description of the commit (optional). Defaults to empty string.

parent_commit

string

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

Parent commit SHA (40-character hexadecimal string). Optional, defaults to HEAD of the revision.

deleted_entries

array

[{"path":"old_file.txt"}]

List of files to delete from the repository


Hugging Face Create Datasets Preupload

Integration name: HUGGING_FACE_CREATE_DATASETS_PREUPLOAD

Tool to check if files should be uploaded via Large File Storage (LFS) or directly to a Hugging Face dataset repository. Use before uploading files to determine the correct upload method for each file based on size and repository settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

Revision (branch or commit) to check preupload for. Typically 'main' for the default branch

repo

string

"test-discussion-dataset"

Name of the dataset repository

files

array

List of files to check for upload method. Maximum 1000 files per request

gitIgnore

string

Content of .gitignore file for the revision. Optional; uses existing .gitignore if not provided

namespace

string

"121tester"

Namespace (username or organization) that owns the dataset repository

gitAttributes

string

Content of .gitattributes file if you plan to modify it yourself. Only needed if managing LFS tracking manually; otherwise HF automatically updates .gitattributes


Hugging Face Create Datasets Tag

Integration name: HUGGING_FACE_CREATE_DATASETS_TAG

Tool to create a tag on a Hugging Face dataset repository. Use when you need to mark a specific revision with a named tag.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch or commit SHA) to create the tag from, typically 'main'.

tag

string

"test-tag-v1.0"

The name of the tag to create (e.g., 'v1.0', 'release-2024').

repo

string

"test-discussion-dataset"

The name of the dataset repository to create a tag for.

message

string

"Test tag creation for endpoint validation"

Optional message describing the purpose of this tag.

namespace

string

"121tester"

The namespace (username or organization) that owns the dataset.


Hugging Face Create Discussions

Integration name: HUGGING_FACE_CREATE_DISCUSSIONS

Tool to create a new discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to start a conversation, report an issue, or create a pull request discussion.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"gpt2"

The name of the repository where the discussion will be created.

title

string

"Test Discussion"

The title of the discussion. Must be between 3 and 200 characters.

namespace

string

"openai-community"

The namespace (username or organization) that owns the repository.

repo_type

string

"models"

The type of repository: models, spaces, or datasets. This determines where the discussion will be created.

description

string

"This is a test discussion created via API to verify endpoint functionality."

The description/content of the discussion. Can contain markdown formatting. Maximum 65536 characters.

pull_request

boolean

false

Whether this discussion should be created as a pull request. If true, creates a PR instead of a regular discussion.


Hugging Face Create Discussions Comment

Integration name: HUGGING_FACE_CREATE_DISCUSSIONS_COMMENT

Tool to create a new comment on a Hugging Face repository discussion. Use when you need to add comments or replies to discussions on models, datasets, or spaces.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

num

string

"1"

The discussion number or ID to comment on. This is the numeric identifier of the discussion thread.

repo

string

"gpt2"

The repository name where the discussion exists. For example, 'gpt2' or 'my-dataset'.

comment

string

"Thanks for the detailed explanation!"

The comment text to post on the discussion. Must be between 1 and 65536 characters.

namespace

string

"openai-community"

The namespace (username or organization) that owns the repository. For example, 'openai-community' or 'huggingface'.

repo_type

string

"models"

The type of repository where the discussion exists. Must be one of: models, spaces, or datasets.


Hugging Face Create Discussions Pin

Integration name: HUGGING_FACE_CREATE_DISCUSSIONS_PIN

Tool to pin or unpin a discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to highlight important discussions by pinning them to the top of the list, or unpin them when they're no longer priority.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

num

string

"1"

The discussion number/identifier to pin or unpin. This is the numeric ID shown in the discussion URL.

repo

string

"test-discussion-pin-repo"

The name of the repository containing the discussion. For example, for 'meta-llama/Llama-2-7b', the repo is 'Llama-2-7b'.

pinned

boolean

true

Whether to pin (true) or unpin (false) the discussion. Pinned discussions appear at the top of the discussions list.

namespace

string

"121tester"

The namespace (username or organization) that owns the repository. For example, for 'meta-llama/Llama-2-7b', the namespace is 'meta-llama'.

repo_type

string

"models"

The type of repository: models, spaces, or datasets. This determines which repository type contains the discussion.


Hugging Face Create Models Branch

Integration name: HUGGING_FACE_CREATE_MODELS_BRANCH

Tool to create a new branch in a Hugging Face model repository. Use when you need to create a branch for experimenting with model changes, versioning, or creating isolated development environments.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"feature-branch"

The name for the new branch to be created (e.g., 'feature-branch', 'experiment-v2'). This will be the branch name in the repository.

repo

string

"Llama-2-7b"

The name of the model repository where the branch will be created. For example, for model 'meta-llama/Llama-2-7b', the repo is 'Llama-2-7b'.

namespace

string

"meta-llama"

The namespace (username or organization) that owns the model repository. For example, for model 'meta-llama/Llama-2-7b', the namespace is 'meta-llama'.

overwrite

boolean

false

Overwrite the branch if it already exists. If False (default), creating a branch that already exists will result in an error.

empty_branch

boolean

false

Create an empty branch without any files. If True, startingPoint is not required. If False (default), startingPoint should be provided.

starting_point

string

"main"

The commit hash or branch name to start the new branch from (e.g., 'main', 'dev', or a commit hash). Required unless creating an empty branch. Defaults to 'main' if not specified and emptyBranch is False.


Hugging Face Create Models Commit

Integration name: HUGGING_FACE_CREATE_MODELS_COMMIT

Tool to create a commit to a Hugging Face model repository. Use when you need to add, update, or delete files in a model repository. Supports both standard JSON and JSON-lines (NDJSON) formats. JSON-lines format is recommended for better performance.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit SHA) to commit to

repo

string

"test-commit-model"

The name of the model repository to commit to

files

array

List of files to add or update in the commit

summary

string

"Add model configuration"

Summary message for the commit. This is a required field that describes the commit

create_pr

string

"1"

Whether to create a pull request from the commit. Typically '1' or 'true' to create a PR

lfs_files

array

List of LFS (Large File Storage) files to add or update

namespace

string

"121tester"

The namespace (user or organization) that owns the model repository

hot_reload

string

"1"

For Spaces, whether to try to hot reload the commit (only for single python files updates). Typically '1' or 'true' to enable hot reload

description

string

"Added new configuration parameters for the model"

Optional detailed description for the commit. Defaults to empty string if not provided

content_type

string

Content type for the request. Use application/x-ndjson (recommended) for JSON-lines format or application/json for standard JSON

parent_commit

string

"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

Optional parent commit SHA (40-character hex string). If provided, the commit will be based on this specific commit

deleted_entries

array

List of files to delete from the repository


Hugging Face Create Models Tag

Integration name: HUGGING_FACE_CREATE_MODELS_TAG

Tool to create a tag on a Hugging Face model repository. Use when you need to mark a specific revision with a named tag.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch or commit SHA) to create the tag from, typically 'main'.

tag

string

"v1.0.1"

The name of the tag to create (e.g., 'v1.0', 'release-2024').

repo

string

"test-tag-creation-model"

The name of the model repository to create a tag for.

message

string

"Second test tag"

Optional message describing the purpose of this tag.

namespace

string

"121tester"

The namespace (username or organization) that owns the model.


Hugging Face Create Papers Comment

Integration name: HUGGING_FACE_CREATE_PAPERS_COMMENT

Tool to create a new comment on a Hugging Face paper. Use when you need to add comments or feedback to research papers on Hugging Face.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

comment

string

"Great paper! The methodology is very innovative."

The comment text to post on the paper. Must be between 1 and 65536 characters.

paper_id

string

"2408.04619"

The unique identifier of the paper to comment on. This can be the paper ID (e.g., '2408.04619') or the full paper path.


Hugging Face Create Papers Comment Reply

Integration name: HUGGING_FACE_CREATE_PAPERS_COMMENT_REPLY

Tool to create a reply to a comment on a Hugging Face paper. Use when you need to respond to an existing comment on a paper discussion.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

comment

string

"This is a great insight!"

The content of the reply comment.

paper_id

string

"2312.09323"

The unique identifier of the paper (e.g., '2312.09323').

comment_id

string

"65844ff1ee15e3c7fc034c97"

The unique identifier of the comment to reply to (e.g., '65844ff1ee15e3c7fc034c97').


Hugging Face Create Papers Index

Integration name: HUGGING_FACE_CREATE_PAPERS_INDEX

Tool to index a paper from arXiv by its ID on Hugging Face. Use when you need to make a paper searchable and accessible on the platform. Note: If the paper is already indexed, only its authors can re-index it.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

arxiv_id

string

"2411.19876"

The arXiv ID of the paper to index (format: YYMM.NNNNN or YYMM.NNNN, e.g., '2411.19876' or '1234.5678'). Only the paper's authors can re-index if already indexed.


Hugging Face Create Repo

Integration name: HUGGING_FACE_CREATE_REPO

Tool to create a new repository (model, dataset, or Space) on Hugging Face Hub. Use when you need to initialize a new repository for uploading models, datasets, or deploying Spaces applications.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

sdk

string

"gradio"

SDK options for Spaces.

name

string

"my-model"

The name of the repository to create. This will be the repository identifier within the namespace.

type

string

"model"

The type of repository to create: model, dataset, or space. Defaults to 'model' if not specified.

private

boolean

true

Whether the repository should be private. If not specified, follows the default visibility setting for your account or organization.

organization

string

"my-org"

The organization namespace to create the repository under. If not provided, the repository will be created under your personal namespace.


Hugging Face Create Spaces Branch

Integration name: HUGGING_FACE_CREATE_SPACES_BRANCH

Tool to create a new branch in a Hugging Face space repository. Use when you need to create a branch for experimenting with space changes, versioning, or creating isolated development environments.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"feature-branch"

The name for the new branch to be created (e.g., 'feature-branch', 'experiment-v2'). This will be the branch name in the repository.

repo

string

"test-branch-space"

The name of the space repository where the branch will be created. For example, for space 'huggingface/my-space', the repo is 'my-space'.

namespace

string

"121tester"

The namespace (username or organization) that owns the space repository. For example, for space 'huggingface/my-space', the namespace is 'huggingface'.

overwrite

boolean

false

Overwrite the branch if it already exists. If False (default), creating a branch that already exists will result in an error.

empty_branch

boolean

false

Create an empty branch without any files. If True, startingPoint is not required. If False (default), startingPoint should be provided.

starting_point

string

"main"

The commit hash or branch name to start the new branch from (e.g., 'main', 'dev', or a commit hash). Required unless creating an empty branch. Defaults to 'main' if not specified and emptyBranch is False.


Hugging Face Create Spaces Commit

Integration name: HUGGING_FACE_CREATE_SPACES_COMMIT

Tool to create a commit in a Hugging Face Space repository. Use when you need to add, update, or delete files in a Space. Supports both JSON and NDJSON (recommended) payload formats for commits.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch or commit) to commit to. Typically 'main' for the default branch

repo

string

"test-commit-space"

The name of the Space repository where the commit will be created. For example, for Space 'user/my-space', the repo is 'my-space'

files

array

List of files to add or update in the commit. For JSON payload format only

summary

string

"Update README"

Summary of the commit (required). This is the commit message title

createPr

string

"true"

Whether to create a pull request from the commit instead of committing directly. Set to 'true' to create a PR, 'false' or omit to commit directly

lfsFiles

array

List of Large File Storage (LFS) files to add or update. For JSON payload format only

hotReload

string

"true"

For Spaces, whether to try to hot reload the commit (only works for single Python file updates). Set to 'true' to enable hot reload

namespace

string

"121tester"

The namespace (username or organization) that owns the Space. For example, for Space 'user/my-space', the namespace is 'user'

contentType

string

Content type for the commit request.

description

string

"Added detailed documentation for setup process"

Detailed description of the commit (optional, defaults to empty string). This is the commit message body

parentCommit

string

"a1aa433138d652a4a65ef64dcc814de076d3d0a6"

The parent commit SHA (40-character hexadecimal). Optional, defaults to current HEAD of the branch

deletedEntries

array

List of file paths to delete in the commit. For JSON payload format only


Hugging Face Create Spaces Secrets

Integration name: HUGGING_FACE_CREATE_SPACES_SECRETS

Tool to create or update a secret in a Hugging Face Space. Use when you need to add or update environment variables or sensitive configuration values for a Space. This action upserts the secret, meaning it will create a new secret if it doesn't exist or update it if it already exists.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"API_KEY"

The name of the secret key. Must start with a letter and contain only letters, digits, and underscores (pattern: ^[a-zA-Z][_a-zA-Z0-9]*$). For example: 'API_KEY', 'DATABASE_URL', 'TEST_SECRET_KEY'.

repo

string

"test-curl-space-delete-secret"

The name of the Space repository where the secret will be created or updated. For example, for Space 'huggingface/my-space', the repo is 'my-space'.

value

string

"test_secret_value_123"

The value of the secret. This will be stored securely and not visible after creation. Defaults to empty string if not provided.

namespace

string

"121tester"

The namespace (username or organization) that owns the Space. For example, for Space 'huggingface/my-space', the namespace is 'huggingface'.

description

string

"Test secret created by curl tester"

Optional description of the secret to help identify its purpose. For example: 'API key for external service', 'Database connection string'.


Hugging Face Create Spaces Tag

Integration name: HUGGING_FACE_CREATE_SPACES_TAG

Tool to create a tag on a Hugging Face space repository. Use when you need to mark a specific revision with a named tag.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch or commit SHA) to create the tag from, typically 'main'.

tag

string

"v1.0.1"

The name of the tag to create (e.g., 'v1.0', 'release-2024').

repo

string

"test-tag-space"

The name of the space repository to create a tag for.

message

string

"Test tag creation via API"

Optional message describing the purpose of this tag.

namespace

string

"121tester"

The namespace (username or organization) that owns the space.


Hugging Face Create Spaces Variables

Integration name: HUGGING_FACE_CREATE_SPACES_VARIABLES

Tool to create or update a variable in a Hugging Face Space. Use when you need to add or update environment variables or configuration values for a Space. This action upserts the variable, meaning it will create a new variable if it doesn't exist or update it if it already exists.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"APP_MODE"

The name of the variable key. Must start with a letter and contain only letters, digits, and underscores (pattern: ^[a-zA-Z][_a-zA-Z0-9]*$). For example: 'APP_MODE', 'DEBUG_ENABLED', 'TEST_VAR_123'.

repo

string

"test-branch-delete"

The name of the Space repository where the variable will be created or updated. For example, for Space 'huggingface/my-space', the repo is 'my-space'.

value

string

"test_value_from_api"

The value of the variable. This will be stored and can be accessed by the Space. Defaults to empty string if not provided.

namespace

string

"121tester"

The namespace (username or organization) that owns the Space. For example, for Space 'huggingface/my-space', the namespace is 'huggingface'.

description

string

"Test variable created via API"

Optional description of the variable to help identify its purpose. For example: 'Environment mode setting', 'Debug flag for development'.


Hugging Face Create Sql Console Embed

Integration name: HUGGING_FACE_CREATE_SQL_CONSOLE_EMBED

Tool to create a SQL Console embed for querying datasets on Hugging Face. Use when you need to create a shareable SQL query interface for exploring dataset splits. The embed allows users to execute SQL queries against dataset views (e.g., train, test, validation splits).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

sql

string

"SELECT * FROM train LIMIT 10"

The SQL query to be embedded in the console. This is the query users will see and can execute.

repo

string

"imdb"

The name of the dataset repository without the namespace prefix.

title

string

"IMDB Sample Query"

Title for the SQL console embed. Maximum 200 characters.

views

array

[{"key":"train_view","viewName":"train","displayName":"Training Data"}]

List of available views (splits) in the dataset that can be queried. Must contain at least one view.

private

boolean

false

Whether the SQL console embed should be private. If true, only authorized users can access it.

repoType

string

The type of repository. Currently only 'datasets' is supported.

namespace

string

"stanfordnlp"

The namespace (username or organization) that owns the dataset repository.


Hugging Face Create Webhook

Integration name: HUGGING_FACE_CREATE_WEBHOOK

Tool to create a webhook on Hugging Face that triggers on repository or discussion events. Use when you need to receive notifications for changes to specific models, datasets, or spaces.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

url

string

"https://webhook.site/test-webhook-endpoint"

The webhook URL endpoint that will receive POST requests when events occur. Must be a valid HTTP/HTTPS URL.

secret

string

"my-secret-key"

Optional secret string used to sign webhook payloads for verification. Must contain only printable ASCII characters (spaces and characters from 0x20 to 0x7F).

domains

array

["repo"]

List of event domains to monitor. At least one domain must be specified. Use 'repo' for repository events or 'discussion' for discussion events.

watched

array

[{"name":"test-model","type":"model"}]

List of repositories to watch for changes. At least one repository must be specified. Events from these repositories will trigger webhook calls.

job_source_id

string

"job-source-123"

Optional job source identifier for associating the webhook with a specific job source.


Hugging Face Delete Datasets Branch

Integration name: HUGGING_FACE_DELETE_DATASETS_BRANCH

Tool to delete a branch from a Hugging Face dataset repository. Use when you need to remove a branch that is no longer needed. This action permanently removes the specified branch from the dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"test-branch-to-delete"

The name of the branch to delete from the dataset repository. This should be a valid branch name (not the main/master branch in most cases).

repo

string

"test-discussion-dataset"

The name of the dataset repository from which to delete the branch. This is the repository identifier without the namespace.

namespace

string

"121tester"

The namespace (user or organization) that owns the dataset. For example, '121tester' for a user or 'huggingface' for an organization.


Hugging Face Delete Datasets Tag

Integration name: HUGGING_FACE_DELETE_DATASETS_TAG

Tool to delete a tag from a Hugging Face dataset. Use when you need to remove a specific tag revision from a dataset repository.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"test-tag-delete"

The tag revision to delete from the dataset.

repo

string

"test-discussion-dataset"

The repository name of the dataset.

namespace

string

"121tester"

The namespace (organization or user) that owns the dataset.


Hugging Face Delete Discussions

Integration name: HUGGING_FACE_DELETE_DISCUSSIONS

Tool to delete a discussion from a Hugging Face repository. Use when you need to remove a discussion that is no longer needed. This action permanently removes the specified discussion from the repository.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

num

string

"1"

The discussion number to delete. This is the unique identifier of the discussion within the repository.

repo

string

"test-discussion-delete"

The name of the repository containing the discussion to delete. This is the repository identifier without the namespace.

namespace

string

"121tester"

The namespace (user or organization) that owns the repository. For example, '121tester' for a user or 'huggingface' for an organization.

repo_type

string

"models"

The type of repository where the discussion exists. Must be one of: models, spaces, or datasets.


Hugging Face Delete Network Cidr List

Integration name: HUGGING_FACE_DELETE_NETWORK_CIDR_LIST

Tool to delete a network CIDR list entry from Hugging Face Inference Endpoints. Use when you need to remove a CIDR configuration that is no longer needed. This action permanently removes the specified CIDR from the namespace's network configuration.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

cidr_id

string

"698dce7899943d11a06fa0a3"

The unique identifier of the CIDR to delete. This is a hexadecimal ID that was returned when the CIDR was created.

namespace

string

"121tester"

The namespace (user or organization) that owns the CIDR configuration. For example, '121tester' for a user or 'my-org' for an organization.


Hugging Face Delete Notifications

Integration name: HUGGING_FACE_DELETE_NOTIFICATIONS

Tool to delete notifications from Hugging Face. Use when you need to remove notifications either by specific discussion IDs or by applying filters to delete multiple notifications at once. Supports targeted deletion (via discussion_ids) or bulk deletion (via applyToAll with filter parameters).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination when filtering notifications. Defaults to 0 (first page).

mention

string

"all"

Enum for mention filter.

paper_id

string

"2307.09288"

Filter notifications by paper ID. Use this to delete notifications related to a specific paper. Only applies when applyToAll is true.

repo_name

string

"huggingface/transformers"

Filter notifications by repository name. Use this to delete notifications from a specific repository. Format should be 'namespace/repo-name'. Only applies when applyToAll is true.

repo_type

string

"model"

Enum for repository type filter.

article_id

string

Filter notifications by article ID. Use this to delete notifications related to a specific article. Only applies when applyToAll is true.

last_update

string

Filter notifications by last update timestamp. Use this to delete notifications updated before or after a specific time. Only applies when applyToAll is true.

post_author

string

"john_doe"

Filter notifications by the username of the post author. Use this to delete notifications from a specific user. Only applies when applyToAll is true.

read_status

string

"all"

Enum for read status filter.

apply_to_all

boolean

true

When true, applies the deletion to all notifications matching the filter criteria (readStatus, repoType, repoName, etc.). Use with caution as this will delete multiple notifications at once. Required when not using discussion_ids.

discussion_ids

array

["507f1f77bcf86cd799439011","507f191e810c19729de860ea"]

Array of specific discussion IDs to delete. Each ID must be exactly 24 hexadecimal characters. Use this for targeted deletion of specific notifications. If provided, other filter parameters are ignored.


Hugging Face Delete Settings Webhooks

Integration name: HUGGING_FACE_DELETE_SETTINGS_WEBHOOKS

Tool to delete a webhook from Hugging Face settings. Use when you need to remove a webhook configuration that is no longer needed.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

webhookId

string

"694964cd9797ba34f1bdfec4"

The unique identifier of the webhook to delete. Must be a 24-character hexadecimal string.


Hugging Face Delete Spaces Branch

Integration name: HUGGING_FACE_DELETE_SPACES_BRANCH

Tool to delete a branch from a Hugging Face space repository. Use when you need to remove a branch that is no longer needed. This action permanently removes the specified branch from the space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"test-delete-branch"

The name of the branch to delete from the space repository. This should be a valid branch name (not the main branch in most cases).

repo

string

"test-branch-delete"

The name of the space repository from which to delete the branch. This is the repository identifier without the namespace.

namespace

string

"121tester"

The namespace (user or organization) that owns the space. For example, '121tester' for a user or 'huggingface' for an organization.


Hugging Face Delete Spaces Secrets

Integration name: HUGGING_FACE_DELETE_SPACES_SECRETS

Tool to delete a secret from a Hugging Face space. Use when you need to remove sensitive credentials or configuration values that are no longer needed. This action permanently removes the specified secret from the space's environment variables.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"TEST_SECRET_TO_DELETE"

The key name of the secret to delete from the space. This should be the exact name of the secret as it appears in the space's settings.

repo

string

"test-curl-space-delete-secret"

The name of the space repository from which to delete the secret. This is the repository identifier without the namespace.

namespace

string

"121tester"

The namespace (user or organization) that owns the space. For example, '121tester' for a user or 'huggingface' for an organization.


Hugging Face Delete Spaces Tag

Integration name: HUGGING_FACE_DELETE_SPACES_TAG

Tool to delete a tag from a Hugging Face space. Use when you need to remove a specific tag revision from a space repository.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"test-tag-delete-v1"

The tag revision to delete from the space.

repo

string

"test-tag-space"

The repository name of the space.

namespace

string

"121tester"

The namespace (organization or user) that owns the space.


Hugging Face Delete Spaces Variables

Integration name: HUGGING_FACE_DELETE_SPACES_VARIABLES

Tool to delete a variable from a Hugging Face space. Use when you need to remove configuration values or environment variables that are no longer needed. This action permanently removes the specified variable from the space's environment.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"TEST_VAR_FOR_DELETE"

The key name of the variable to delete from the space. This should be the exact name of the variable as it appears in the space's settings.

repo

string

"test-branch-delete"

The name of the space repository from which to delete the variable. This is the repository identifier without the namespace.

namespace

string

"121tester"

The namespace (user or organization) that owns the space. For example, '121tester' for a user or 'huggingface' for an organization.


Hugging Face Filter Dataset Rows

Integration name: HUGGING_FACE_FILTER_DATASET_ROWS

Tool to filter rows in a Hugging Face dataset split based on SQL-like query conditions. Use when you need to search or filter specific rows from a dataset based on column values, or to retrieve sorted subsets of data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

split

string

"train"

Name of the dataset split to filter (e.g., 'train', 'test', 'validation').

where

string

"label=0"

SQL WHERE clause for filtering rows. Use column names and comparison operators (e.g., 'label=0', 'score>0.5', 'text LIKE "%happy%"'). Multiple conditions can be combined with AND/OR.

config

string

"default"

Name of the dataset configuration/subset to filter. Use 'default' for datasets without explicit configs.

length

integer

5

Maximum number of rows to return. Defaults to 100. Maximum allowed is 100.

offset

integer

0

Number of rows to skip before returning results. Use with length for pagination.

dataset

string

"cornell-movie-review-data/rotten_tomatoes"

Full name of the dataset in the format 'namespace/dataset-name'. Example: 'cornell-movie-review-data/rotten_tomatoes'.

orderby

string

"score DESC"

SQL ORDER BY clause for sorting results. Specify column name and optionally 'ASC' or 'DESC' (e.g., 'score DESC', 'date ASC').


Hugging Face Generate Chat Completion

Integration name: HUGGING_FACE_GENERATE_CHAT_COMPLETION

Tool to generate a response given a list of messages in a conversational context. Supports both conversational Language Models (LLMs) and Vision-Language Models (VLMs). Compatible with OpenAI SDK.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

seed

integer

42

Random seed for deterministic sampling. Using the same seed with the same parameters should produce the same output.

stop

array

["\\n","END"]

Up to 4 sequences where the API will stop generating further tokens. The returned text will not contain the stop sequence.

model

string

"meta-llama/Llama-3.2-3B-Instruct"

The model ID to use for chat completion. Format: namespace/model or namespace/model:provider. Examples: 'meta-llama/Llama-3.2-3B-Instruct', 'Qwen/Qwen2.5-7B-Instruct-1M'.

tools

array

A list of tools the model may call. Currently, only functions are supported as a tool. Use this to provide a list of functions the model may generate JSON inputs for.

top_p

number

0.9

An alternative to sampling with temperature, called nucleus sampling. The model considers the results of tokens with top_p probability mass. So 0.1 means only tokens comprising the top 10% probability mass are considered.

stream

boolean

false

Whether to stream the response as Server-Sent Events. If true, tokens are returned as they are generated. If false (default), the full response is returned at once.

logprobs

boolean

false

Whether to return log probabilities of the output tokens. If true, returns the log probabilities of each output token returned in the content of message.

messages

array

A list of messages comprising the conversation so far. Each message has a role (system, user, assistant, tool) and content.

max_tokens

integer

50

The maximum number of tokens that can be generated in the chat completion. If not specified, the model will generate until it reaches a natural stopping point.

temperature

number

0.7

Sampling temperature between 0 and 2. Higher values like 0.8 make output more random, lower values like 0.2 make it more focused and deterministic. We generally recommend altering this or top_p but not both.

tool_choice

Controls which (if any) tool is called by the model. 'auto' (default) means the model can pick between generating a message or calling a tool. 'none' means the model will not call a tool. 'required' means the model must call a tool. Or specify a particular function to force the model to call it.

tool_prompt

string

A prompt to be appended before the tools section.

top_logprobs

integer

2

An integer between 0 and 5 specifying the number of most likely tokens to return at each token position, each with an associated log probability. logprobs must be set to true if this parameter is used.

stream_options

object

Stream options.

response_format

The format of the response. Can be 'text' (default), 'json_object' for JSON mode, or 'json_schema' for structured output with a specific schema.

presence_penalty

number

0

Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics.

frequency_penalty

number

0

Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim.


Hugging Face Generate Embeddings

Integration name: HUGGING_FACE_GENERATE_EMBEDDINGS

Tool to convert text into vector embeddings for feature extraction, semantic search, and similarity tasks. Use when you need numerical representations of text for ML applications.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

model

string

"sentence-transformers/all-MiniLM-L6-v2"

The Hugging Face model ID to use for generating embeddings. Must be a valid embedding model from the Hugging Face model hub.

inputs

array

["Hello, this is a test text for embeddings."]

Array of text strings to convert into embeddings. Each string will be processed and returned as a numerical vector representation.


Hugging Face Get Daily Papers

Integration name: HUGGING_FACE_GET_DAILY_PAPERS

Tool to retrieve daily papers from Hugging Face. Use when you need to fetch the latest AI/ML research papers shared on Hugging Face.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination (0-indexed). Defaults to 0.

date

string

"2024-01-15"

Filter papers by specific date (YYYY-MM-DD format).

sort

string

"publishedAt"

Sort option for daily papers.

week

string

"2024-W03"

Filter papers by specific week.

limit

integer

10

Maximum number of papers to return per page. Defaults to 50.

month

string

"2024-01"

Filter papers by specific month (YYYY-MM format).

submitter

string

"username123"

Filter papers by submitter username.


Hugging Face Get Dataset Croissant

Integration name: HUGGING_FACE_GET_DATASET_CROISSANT

Tool to get Croissant metadata about a Hugging Face dataset. Croissant is a metadata format built on schema.org aimed at describing datasets used for machine learning. Use when you need structured metadata in JSON-LD format.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

dataset

string

"ibm-research/duorc"

Full dataset name in format 'namespace/repo' (e.g., 'ibm-research/duorc', 'squad', 'huggingface/transformers').


Hugging Face Get Dataset First Rows

Integration name: HUGGING_FACE_GET_DATASET_FIRST_ROWS

Tool to get the first 100 rows of a dataset split along with column data types and features. Use when you need to preview or sample dataset content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

split

string

"train"

Name of the dataset split to retrieve rows from.

config

string

"default"

Name of the dataset configuration/subset. Use 'default' for datasets without configurations.

dataset

string

"cornell-movie-review-data/rotten_tomatoes"

Name of the dataset in format 'namespace/name'. For example, 'cornell-movie-review-data/rotten_tomatoes' or 'squad'.


Hugging Face Get Dataset Info

Integration name: HUGGING_FACE_GET_DATASET_INFO

Tool to get general information about a dataset including description, citation, homepage, license, and features (column schemas). Use when you need to understand dataset structure, available splits, and metadata before working with the data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

config

string

"SelfRC"

Name of the config/subset to retrieve information for. If not provided, returns info for the default configuration.

dataset

string

"rajpurkar/squad"

Name of the dataset to retrieve information for. Format: 'namespace/repo-name' (e.g., 'rajpurkar/squad', 'ibm/duorc').


Hugging Face Get Dataset Repo Info

Integration name: HUGGING_FACE_GET_DATASET_REPO_INFO

Tool to retrieve detailed information about a Hugging Face dataset repository. Use when you need metadata, card data, tags, downloads, likes, configurations, or other information about a specific dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo_id

string

"rajpurkar/squad"

Dataset repository ID in the format author/dataset-name (e.g., 'rajpurkar/squad', 'stanfordnlp/imdb')

revision

string

"main"

Git revision (branch, tag, or commit SHA) to retrieve information for. If not specified, defaults to the main branch


Hugging Face Get Dataset Rows

Integration name: HUGGING_FACE_GET_DATASET_ROWS

Tool to retrieve a slice of rows from a Hugging Face dataset split at any given location (offset). Returns up to 100 rows at a time with complete feature type information and no truncation. Use when you need to inspect specific rows from a dataset without downloading the entire dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

split

string

"train"

Name of the dataset split to retrieve rows from. Common splits include 'train', 'test', and 'validation'.

config

string

"plain_text"

Name of the config/subset of the dataset. Each dataset may have multiple configurations for different variations or subsets.

length

integer

10

Number of rows to retrieve. Maximum allowed value is 100. Use smaller values for faster responses.

offset

integer

0

Starting row index (0-based) from which to begin retrieving rows. Use 0 to start from the beginning of the dataset.

dataset

string

"stanfordnlp/imdb"

Name of the dataset to retrieve rows from. Use format 'namespace/dataset_name' (e.g., 'stanfordnlp/imdb', 'ibm/duorc').


Hugging Face Get Datasets Compare

Integration name: HUGGING_FACE_GET_DATASETS_COMPARE

Tool to get a comparison (diff) between two revisions of a Hugging Face dataset. Use when you need to see what changed between dataset versions or commits.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

raw

boolean

Whether to return the raw diff output. If false or not provided, returns formatted diff.

repo

string

"squad"

The name of the dataset repository to compare.

compare

string

"main~1..main"

The comparison specification in the format 'base..head' (e.g., 'main~1..main' for comparing the previous commit to main, or 'abc123..def456' for comparing specific commits).

namespace

string

"rajpurkar"

The namespace (username or organization) that owns the dataset.


Hugging Face Get Dataset Size

Integration name: HUGGING_FACE_GET_DATASET_SIZE

Tool to get the size of a Hugging Face dataset including number of rows and size in bytes. Use when you need to determine dataset size, memory requirements, or storage needs for a specific dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

dataset

string

"stanfordnlp/imdb"

Name of the dataset to get size information for. Format: 'namespace/repo-name' (e.g., 'stanfordnlp/imdb', 'ibm/duorc').


Hugging Face Get Datasets Jwt

Integration name: HUGGING_FACE_GET_DATASETS_JWT

Tool to generate a JWT token for accessing a Hugging Face dataset repository. Use when you need authenticated access to datasets, optionally with write access for spaces in dev mode, custom expiration, or encryption.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"squad"

The name of the dataset repository.

write

string

"true"

Enable write access for spaces in dev mode. Set to 'true' to enable write access.

encrypted

string

"true"

Request an encrypted JWT token. Set to 'true' to receive encrypted token with key ID.

namespace

string

"rajpurkar"

The namespace (organization or user) that owns the dataset repository.

expiration

string

"3600"

Custom expiration time for the JWT token. Format depends on Hugging Face API specifications.

inference_api

string

"true"

Enable inference API access. Set to 'true' to enable.

include_pro_status

string

"true"

Include Pro status information in the token. Set to 'true' to include.


Hugging Face Get Datasets Leaderboard

Integration name: HUGGING_FACE_GET_DATASETS_LEADERBOARD

Tool to retrieve evaluation results ranked by score for a dataset's leaderboard. Use when you need to compare model performance on a specific dataset or task. Returns an array of leaderboard entries with model information, scores, and rankings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"results"

The repository name of the dataset. For example, 'results' for the dataset 'open-llm-leaderboard/results'.

task_id

string

"text-classification"

Optional task identifier to filter leaderboard results by a specific task. If not provided, returns results for all tasks.

namespace

string

"open-llm-leaderboard"

The namespace (organization or user) that owns the dataset. For example, 'open-llm-leaderboard' for the dataset 'open-llm-leaderboard/results'.


Hugging Face Get Datasets Notebook

Integration name: HUGGING_FACE_GET_DATASETS_NOTEBOOK

Tool to get a Jupyter notebook URL from a Hugging Face dataset repository. Use when you need to retrieve the URL for a specific .ipynb file from a dataset at a particular revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit hash) to retrieve the notebook from.

path

string

"Alpaca_+_Llama_7b_full_example.ipynb"

The path to the notebook file within the repository, including the .ipynb extension.

repo

string

"notebooks"

The repository name of the dataset.

namespace

string

"unsloth"

The namespace (user or organization) that owns the dataset.


Hugging Face Get Datasets Resolve

Integration name: HUGGING_FACE_GET_DSETS_RESOLVE

Tool to resolve and download a file from a Hugging Face dataset repository. This endpoint requires following redirections to retrieve file content or returns XET file info when Accept header is set appropriately. Use when you need to access files from datasets with proper redirection handling.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (commit SHA, branch name, or tag) to resolve the file from.

path

string

"README.md"

The path to the file within the repository (wildcard path parameter).

repo

string

"imdb"

The name of the dataset repository.

Range

string

"bytes=0-1023"

The range in bytes of the file to download (e.g., 'bytes=0-1023' for first 1KB).

Accept

string

"application/vnd.xet-fileinfo+json"

Returns json information about the XET file info if the file is a XET file. Use 'application/vnd.xet-fileinfo+json' to get XET metadata, otherwise leave empty to download file content.

namespace

string

"stanfordnlp"

The namespace (organization or user) that owns the dataset repository.


Hugging Face Get Datasets Scan

Integration name: HUGGING_FACE_GET_DATASETS_SCAN

Tool to retrieve the security scan status of a Hugging Face dataset repository. Use when you need to check for malware, pickle vulnerabilities, or other security issues in a dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"squad"

The name of the dataset repository to scan

namespace

string

"rajpurkar"

The namespace (organization or user) that owns the dataset repository


Hugging Face Get Datasets Tags By Type

Integration name: HUGGING_FACE_GET_DATASETS_TAGS_BY_TYPE

Tool to retrieve all possible tags used for datasets on Hugging Face, grouped by tag type. Use when you need to discover available dataset classification tags, filter options, or metadata categories. Optionally restrict results to a single tag type.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

type

string

"language"

Valid tag type values for filtering dataset tags.


Hugging Face Get Dataset Statistics

Integration name: HUGGING_FACE_GET_DATASET_STATISTICS

Tool to get comprehensive statistics about a dataset split including column statistics and data distribution information. Use when you need to analyze dataset composition, understand data distributions, or get statistical summaries of dataset features.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

split

string

"train"

Name of the split to get statistics for (e.g., 'train', 'test', 'validation').

config

string

"mnist"

Name of the configuration/subset of the dataset (e.g., 'mnist', 'cola', 'default').

dataset

string

"ylecun/mnist"

Name of the dataset. Format: 'namespace/dataset-name' (e.g., 'ylecun/mnist', 'nyu-mll/glue').


Hugging Face Get Datasets Treesize

Integration name: HUGGING_FACE_GET_DATASETS_TREESIZE

Tool to get the total size of a Hugging Face dataset repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The Git revision or branch name to query (e.g., 'main', 'dev', or a commit SHA).

path

string

"."

The path within the repository to calculate size for. Use '.' for root directory or specify a subdirectory path (e.g., 'data/train'). The size is calculated recursively for all files under this path.

repo

string

"gsm8k"

The repository name of the dataset (e.g., 'gsm8k', 'wikitext').

namespace

string

"squad"

The namespace or organization name that owns the dataset (e.g., 'squad', 'openai').


Hugging Face Get Datasets Xet Read Token

Integration name: HUGGING_FACE_GET_DATASETS_XET_READ_TOKEN

Tool to get a read short-lived access token for XET from Hugging Face datasets. Use when you need temporary read access to dataset content through XET protocol.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch, tag, or commit) to get the token for. Use 'main' for the default branch.

repo

string

"squad"

The repository name of the dataset. For example, 'squad' for the SQuAD dataset.

namespace

string

"rajpurkar"

The namespace (organization or user) that owns the dataset. For example, 'rajpurkar' for the SQuAD dataset.


Hugging Face Get Discussion

Integration name: HUGGING_FACE_GET_DISCUSSION

Tool to get detailed information about a specific discussion or pull request on Hugging Face Hub. Use when you need to retrieve all comments, status changes, events, and for PRs, the diff information.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo_id

string

"google-bert/bert-base-uncased"

Repository ID in the format author/repo-name (e.g., 'google-bert/bert-base-uncased').

repo_type

string

"models"

The type of repository: models, spaces, or datasets. This determines where to look for the discussion.

discussion_num

integer

1

Discussion number (strictly positive integer). This is the unique identifier of the discussion within the repository.


Hugging Face Get Jobs Hardware

Integration name: HUGGING_FACE_GET_JOBS_HARDWARE

Tool to retrieve available hardware configurations for Hugging Face Jobs with their specifications and pricing. Use when you need to discover compute options for running jobs.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face Get Model Info

Integration name: HUGGING_FACE_GET_MODEL_INFO

Tool to retrieve detailed information about a Hugging Face model repository. Use when you need comprehensive metadata including downloads, likes, tags, configuration, files, and more.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"bert-base-uncased"

The repository name of the model. For example, 'bert-base-uncased' in 'google-bert/bert-base-uncased'.

namespace

string

"google-bert"

The namespace (organization or user) that owns the model repository. For example, 'google-bert' in 'google-bert/bert-base-uncased'.


Hugging Face Get Models Compare

Integration name: HUGGING_FACE_GET_MODELS_COMPARE

Tool to compare two revisions of a Hugging Face model repository. Returns a git diff showing file changes between commits. Use when you need to see what changed between model versions.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

raw

boolean

If true, returns raw diff output. If false or omitted, returns formatted diff.

repo

string

"bert-base-uncased"

The repository name of the model (e.g., 'bert-base-uncased', 'llama-2-7b').

compare

string

"5546055f03398095e385d7dc625e636cc8910bf2..86b5e0934494bd15c9632b12f734a8a67f723594"

Comparison specification in the format 'commit1..commit2' (two dots). Each commit is a full Git commit hash. For example: '5546055f03398095e385d7dc625e636cc8910bf2..86b5e0934494bd15c9632b12f734a8a67f723594'. Do NOT use three dots (...) as this format is not supported by the API.

namespace

string

"google-bert"

The namespace or organization name that owns the model (e.g., 'google-bert', 'meta-llama', 'openai').


Hugging Face Get Models Jwt

Integration name: HUGGING_FACE_GET_MODELS_JWT

Tool to generate a JWT token for accessing a Hugging Face model repository. Use when you need authenticated access to models, with optional write access for spaces in dev mode, custom expiration, and encryption support.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"bert-base-uncased"

The repository name within the namespace.

write

string

"true"

Enable write access for spaces in dev mode. Set to 'true' to enable write access.

encrypted

string

"true"

Request an encrypted token. Set to 'true' to receive an encrypted JWT token and key ID.

namespace

string

"google-bert"

The namespace (organization or user) that owns the model repository.

expiration

string

"3600"

Custom expiration time for the JWT token. Specify the duration or timestamp for token validity.

inference_api

string

"true"

Enable inference API access with the token. Set to 'true' to enable.

include_pro_status

string

"true"

Include PRO subscription status in the token. Set to 'true' to include PRO status information.


Hugging Face Get Models Notebook

Integration name: HUGGING_FACE_GET_MODELS_NOTEBOOK

Tool to retrieve a Jupyter notebook URL from a Hugging Face model repository. Use when you need to access or display a notebook file stored in a model repository.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision, branch name, tag, or commit hash to retrieve the notebook from (e.g., 'main', 'dev', or a commit SHA).

path

string

"Untitled.ipynb"

The path to the Jupyter notebook file within the repository, including the .ipynb extension (e.g., 'Untitled.ipynb' or 'notebooks/demo.ipynb').

repo

string

"example-huggingface-model"

The repository name of the model (e.g., 'example-huggingface-model').

namespace

string

"akshat-shethia"

The namespace or organization name that owns the model repository (e.g., 'akshat-shethia').


Hugging Face Get Models Scan

Integration name: HUGGING_FACE_GET_MODELS_SCAN

Tool to retrieve the security scan status of a Hugging Face model repository. Use when you need to check if a model has been scanned for security issues and view any detected problems.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"opt-125m"

The repository name of the model. For example, 'opt-125m' in 'facebook/opt-125m'.

namespace

string

"facebook"

The namespace (organization or user) that owns the model repository. For example, 'facebook' in 'facebook/opt-125m'.


Hugging Face Get Models Treesize

Integration name: HUGGING_FACE_GET_MODELS_TREESIZE

Tool to get the total size of a Hugging Face model repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The Git revision or branch name to query (e.g., 'main', 'dev', or a commit SHA).

path

string

"."

The path within the repository to calculate size for. Use '.' for root directory or specify a subdirectory path (e.g., 'weights', 'config'). The size is calculated recursively for all files under this path.

repo

string

"bert-base-uncased"

The repository name of the model (e.g., 'bert-base-uncased', 'llama-2-7b').

namespace

string

"google-bert"

The namespace or organization name that owns the model (e.g., 'google-bert', 'facebook', 'openai').


Hugging Face Get Models Xet Read Token

Integration name: HUGGING_FACE_GET_MODELS_XET_READ_TOKEN

Tool to retrieve a short-lived XET read access token for a Hugging Face model repository. Use when you need to access XET (eXtensible Tensor) data for a specific model revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch, tag, or commit hash) to get the XET read token for. Common values include 'main', 'master', or specific commit hashes.

repo

string

"bert-base-uncased"

The repository name of the model. For example, 'bert-base-uncased' in 'google-bert/bert-base-uncased'.

namespace

string

"google-bert"

The namespace (organization or user) that owns the model repository. For example, 'google-bert' in 'google-bert/bert-base-uncased'.


Hugging Face Get Model Tags By Type

Integration name: HUGGING_FACE_GET_MODEL_TAGS_BY_TYPE

Tool to retrieve all possible tags used for Hugging Face models, grouped by tag type. Use when you need to discover available model tags for filtering or categorization. Optionally restrict results to a specific tag type.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

type

string

"pipeline_tag"

Enum for model tag types on Hugging Face.


Hugging Face Get Organizations Avatar

Integration name: HUGGING_FACE_GET_ORGANIZATIONS_AVATAR

Tool to retrieve the avatar URL for a Hugging Face organization. Use when you need to get the avatar image URL for a specific organization.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"huggingface"

The name of the organization. For example, 'huggingface' or 'meta-llama'.

redirect

string

"true"

If provided, redirect to the avatar URL instead of returning it as JSON. Set to any value to enable redirection.


Hugging Face Get Organizations Members

Integration name: HUGGING_FACE_GET_ORGANIZATIONS_MEMBERS

Tool to retrieve a list of members for a Hugging Face organization. Use when you need to discover who belongs to an organization, with optional filtering by search terms, email, and pagination support.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"huggingface"

Name of the organization to retrieve members from. This is the organization's username or slug on Hugging Face.

email

string

"user@example.com"

Filter members by email address. This may require admin permissions depending on the organization's settings.

limit

integer

10

Maximum number of members to return. Defaults to 500.

cursor

string

Pagination cursor for fetching the next page of results. Use the cursor from the previous response to get more members.

search

string

"john"

Search query to filter members by username or full name. Use this to find specific members within the organization.


Hugging Face Get Organizations Socials

Integration name: HUGGING_FACE_GET_ORGANIZATIONS_SOCIALS

Tool to retrieve an organization's social media handles from Hugging Face. Use when you need to find an organization's GitHub, LinkedIn, or Twitter/X profiles. Only returns handles that the organization has publicly shared on their Hugging Face profile.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

name

string

"huggingface"

The name of the organization to retrieve social media handles for. This is the organization's username on Hugging Face.


Hugging Face Get Resolve

Integration name: HUGGING_FACE_GET_RESOLVE

Tool to resolve a file in a Hugging Face repository. Use when you need to access files from model, dataset, or space repositories. This endpoint follows redirections (302, 307) to retrieve the actual file. When Accept header is set to 'application/vnd.xet-fileinfo+json', returns JSON file metadata instead of redirecting to file content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch, tag, or commit hash) to resolve. Common values include 'main' or specific Git commit SHAs.

path

string

"config.json"

The file path within the repository to resolve. For example, 'config.json', 'pytorch_model.bin', or 'tokenizer.json'.

repo

string

"bart-large"

The repository name within the namespace. For example, 'bart-large' in 'facebook/bart-large'.

Range

string

"bytes=0-1023"

The range in bytes of the file to download. Use HTTP Range header format like 'bytes=0-1023' to download only specific byte ranges.

Accept

string

"application/vnd.xet-fileinfo+json"

Returns JSON information about the XET file info if the file is a XET file. Set to 'application/vnd.xet-fileinfo+json' to receive JSON file metadata instead of following redirect to file content.

namespace

string

"facebook"

The namespace (organization or user) that owns the repository. For example, 'facebook' in 'facebook/bart-large'.


Hugging Face Get Resolve Cache Datasets

Integration name: HUGGING_FACE_GET_RESOLVE_CACHE_DATASETS

Tool to resolve a file from cache in a Hugging Face dataset repository. This endpoint follows redirections (302, 307) to retrieve file content or returns XET file info when Accept header is set appropriately. Use when you need to access cached files from datasets with proper redirection handling.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"7b6d24c440a36b6815f21b70d25016731768db1f"

The git revision (commit SHA, branch, or tag) to resolve the file from. Note: This endpoint typically requires an exact commit SHA rather than branch names.

path

string

"README.md"

The path to the file within the repository (wildcard path parameter).

repo

string

"squad"

The name of the dataset repository.

Range

string

"bytes=0-1023"

The range in bytes of the file to download (e.g., 'bytes=0-1023' for first 1KB).

Accept

string

"application/vnd.xet-fileinfo+json"

Returns json information about the XET file info if the file is a XET file. Use 'application/vnd.xet-fileinfo+json' to get XET metadata, otherwise leave empty to download file content.

namespace

string

"rajpurkar"

The namespace (organization or user) that owns the dataset repository.


Hugging Face Get Resolve Cache Models

Integration name: HUGGING_FACE_GET_RESOLVE_CACHE_MODELS

Tool to resolve and retrieve files from the Hugging Face model cache. Use when you need to access model configuration files, tokenizer files, or other JSON metadata files from a specific model repository. This endpoint returns the actual file content as JSON for JSON files (e.g., config.json, tokenizer.json, tokenizer_config.json).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"86b5e0934494bd15c9632b12f734a8a67f723594"

The revision to resolve. Must be a full Git commit SHA (40 characters). Branch names like 'main' or tags are not supported by this endpoint.

path

string

"config.json"

The file path within the repository to resolve. For example, 'config.json', 'pytorch_model.bin', or 'tokenizer.json'.

repo

string

"bert-base-uncased"

The repository name of the model. For example, 'bert-base-uncased' in 'google-bert/bert-base-uncased'.

Range

string

"bytes=0-1023"

The range in bytes of the file to download. Use HTTP Range header format like 'bytes=0-1023'.

Accept

string

"application/json"

Optional Accept header to specify the desired response format. Common values include 'application/json', 'application/vnd.xet-fileinfo+json', or '/'.

namespace

string

"google-bert"

The namespace (organization or user) that owns the model repository. For example, 'google-bert' in 'google-bert/bert-base-uncased'.


Hugging Face Get Resolve Cache Spaces

Integration name: HUGGING_FACE_GET_RESOLVE_CACHE_SPACES

Tool to resolve and retrieve a file from Hugging Face Spaces cache. Use when you need to download a file from a Space repository or get XET file information. This endpoint follows redirections (HTTP 302/307) to resolve the final file location.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit hash) to retrieve the file from. Use a full commit SHA for exact version, or 'main' for the default branch.

path

string

"README.md"

The path to the file within the repository. This is a wildcard path parameter that can include subdirectories and filename.

repo

string

"gradio-user-history"

The repository name of the Space. For example, 'gradio-user-history' for the Wauplin/gradio-user-history Space.

Range

string

"bytes=0-1023"

The range in bytes of the file to download. Format: 'bytes=start-end'. If not provided, the entire file will be retrieved.

Accept

string

"application/vnd.xet-fileinfo+json"

Accept header to specify the response format. Use 'application/vnd.xet-fileinfo+json' to get JSON information about XET file info instead of the file content.

namespace

string

"Wauplin"

The namespace (user or organization) that owns the Space. For example, 'Wauplin' for the Wauplin/gradio-user-history Space.


Hugging Face Get Settings Billing Usage Jobs

Integration name: HUGGING_FACE_GET_SETTINGS_BILLING_USAGE_JOBS

Tool to retrieve Jobs usage and billing information for the current subscription period from Hugging Face. Use when you need to check compute usage, costs, or job execution details for the authenticated user or organization.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face Get Settings Billing Usage Live

Integration name: HUGGING_FACE_GET_SETTINGS_BILLING_USAGE_LIVE

Tool to retrieve live billing usage stream from Hugging Face. Use when you need real-time updates on storage, inference, Zero GPU usage, and rate limits.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

timeout

integer

5

Maximum time in seconds to wait for live usage updates. Defaults to 5 seconds.


Hugging Face Get Settings Billing Usage V2

Integration name: HUGGING_FACE_GET_SETTINGS_BILLING_USAGE_V2

Tool to retrieve user billing usage for a custom date range from Hugging Face. Use when you need to check usage statistics or resource consumption between specific dates using Unix timestamps.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

endDate

integer

1706745600

End date of the billing period as Unix timestamp (seconds since epoch). Defines the end of the date range for which to retrieve usage data. Must be after start_date.

startDate

integer

1704067200

Start date of the billing period as Unix timestamp (seconds since epoch). Defines the beginning of the date range for which to retrieve usage data.


Hugging Face Get Settings Mcp

Integration name: HUGGING_FACE_GET_SETTINGS_MCP

Tool to retrieve MCP (Model Context Protocol) tools configuration for the authenticated user. Use when you need to discover available built-in tools and space-based tools configured in the user's Hugging Face settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face Get Settings Webhooks

Integration name: HUGGING_FACE_GET_SETTINGS_WEBHOOKS

Tool to retrieve a specific webhook configuration from Hugging Face settings. Use when you need to inspect webhook details, verify webhook status, or check webhook configuration for a given webhook ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

webhookId

string

"694964cd9797ba34f1bdfec4"

The unique identifier of the webhook to retrieve. Must be a 24-character hexadecimal string.


Hugging Face Get Space Info

Integration name: HUGGING_FACE_GET_SPACE_INFO

Tool to retrieve detailed information about a Hugging Face Space repository. Use when you need metadata, SDK type, hardware configuration, runtime status, or other information about a specific Space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo_id

string

"Qwen/Qwen3-TTS"

Space repository ID in the format author/space-name (e.g., 'Qwen/Qwen3-TTS', 'stabilityai/stable-diffusion')

revision

string

"main"

Git revision (branch, tag, or commit SHA) to retrieve information for. If not specified, defaults to the main branch


Hugging Face Get Spaces Compare

Integration name: HUGGING_FACE_GET_SPACES_COMPARE

Tool to compare two revisions of a Hugging Face Space repository. Returns a git diff showing file changes between commits. Use when you need to see what changed between Space versions.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

raw

boolean

If true, returns raw diff output. If false or omitted, returns formatted diff.

repo

string

"Qwen3-TTS"

The repository name of the Space (e.g., 'Qwen3-TTS', 'chatgpt-demo').

compare

string

"bb80b9adea7bc1d818bc635e839db60b7d4aa8f1..8a132844625e28e09f36427c30070276dfd9b2ed"

Comparison specification in the format 'commit1..commit2' (two dots). Each commit is a full Git commit hash. For example: 'bb80b9adea7bc1d818bc635e839db60b7d4aa8f1..8a132844625e28e09f36427c30070276dfd9b2ed'. Do NOT use three dots (...) as this format is not supported by the API.

namespace

string

"Qwen"

The namespace or organization name that owns the Space (e.g., 'Qwen', 'openai', 'gradio').


Hugging Face Get Spaces Events

Integration name: HUGGING_FACE_GET_SPACES_EVENTS

Tool to stream status updates for a Hugging Face Space using SSE protocol. Use when you need to monitor Space build stages, runtime status, or receive real-time updates about Space state changes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"Qwen3-TTS"

The repository name of the Space.

timeout

integer

3

Maximum time in seconds to wait for status updates. Defaults to 5 seconds.

namespace

string

"Qwen"

The namespace (username or organization) that owns the Space.

session_uuid

string

"550e8400-e29b-41d4-a716-446655440000"

Optional session UUID to filter events for a specific session.


Hugging Face Get Spaces Jwt

Integration name: HUGGING_FACE_GET_SPACES_JWT

Tool to generate a JWT token for accessing a Hugging Face space repository. Use when you need authenticated access to spaces, with optional write access for spaces in dev mode, custom expiration, and encryption support.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"Qwen3-TTS"

The name of the space repository.

write

string

"true"

Enable write access for spaces in dev mode. Set to 'true' to enable write access.

encrypted

string

"true"

Request an encrypted token. Set to 'true' to receive an encrypted JWT token and key ID.

namespace

string

"Qwen"

The namespace (organization or user) that owns the space repository.

expiration

string

"3600"

Custom expiration time for the JWT token. Specify the duration or timestamp for token validity.

inference_api

string

"true"

Enable inference API access with the token. Set to 'true' to enable.

include_pro_status

string

"true"

Include PRO subscription status in the token. Set to 'true' to include PRO status information.


Hugging Face Get Spaces Metrics

Integration name: HUGGING_FACE_GET_SPACES_METRICS

Tool to get live metrics for a specific Space in a streaming fashion, with SSE protocol, such as current Zero-GPU usage. Use when you need real-time monitoring of Space resource utilization.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"Qwen3-TTS"

The repository name of the Space.

timeout

integer

5

Maximum time in seconds to wait for metrics updates. Defaults to 5 seconds.

namespace

string

"Qwen"

The namespace (username or organization) that owns the Space.


Hugging Face Get Spaces Notebook

Integration name: HUGGING_FACE_GET_SPACES_NOTEBOOK

Tool to retrieve a Jupyter notebook URL from a Hugging Face space repository. Use when you need to access or display a notebook file stored in a space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision, branch name, tag, or commit hash to retrieve the notebook from (e.g., 'main', 'dev', or a commit SHA).

path

string

"notebooks/automatic_mask_generator_example.ipynb"

The path to the Jupyter notebook file within the repository, including the .ipynb extension (e.g., 'notebooks/automatic_mask_generator_example.ipynb').

repo

string

"SAM2-Video-Predictor"

The repository name of the space (e.g., 'SAM2-Video-Predictor').

namespace

string

"fffiloni"

The namespace or organization name that owns the space repository (e.g., 'fffiloni').


Hugging Face Get Spaces Resolve

Integration name: HUGGING_FACE_GET_SPACES_RESOLVE

Tool to resolve and retrieve a file from a Hugging Face Space repository. Use when you need to download a file from a Space or get XET file information. This endpoint follows redirections (HTTP 302/307) to resolve the final file location.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The git revision (branch, tag, or commit hash) to retrieve the file from. Use 'main' for the default branch or a specific commit SHA for exact version.

path

string

"README.md"

The file path within the repository to resolve. This wildcard path parameter can include subdirectories and filename.

repo

string

"stable-diffusion-3-medium"

The repository name of the Space. For example, 'stable-diffusion-3-medium' for the stabilityai/stable-diffusion-3-medium Space.

Range

string

"bytes=0-1023"

The range in bytes of the file to download. Format: 'bytes=start-end'. If not provided, the entire file will be retrieved.

Accept

string

"application/vnd.xet-fileinfo+json"

Accept header to specify the response format. Use 'application/vnd.xet-fileinfo+json' to get JSON information about XET file info instead of the file content.

namespace

string

"stabilityai"

The namespace (user or organization) that owns the Space. For example, 'stabilityai' for the stabilityai/stable-diffusion-3-medium Space.


Hugging Face Get Spaces Scan

Integration name: HUGGING_FACE_GET_SPACES_SCAN

Tool to retrieve the security scan status of a Hugging Face space repository. Use when you need to check for malware, pickle vulnerabilities, or other security issues in a space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"stable-diffusion-3-medium"

The name of the space repository to check security status for

namespace

string

"stabilityai"

The namespace (organization or user) that owns the space repository


Hugging Face Get Spaces Treesize

Integration name: HUGGING_FACE_GET_SPACES_TREESIZE

Tool to get the total size of a Hugging Face space repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The Git revision or branch name to query (e.g., 'main', 'dev', or a commit SHA).

path

string

"."

The path within the repository to calculate size for. Use '.' for root directory or specify a subdirectory path (e.g., 'static/images'). The size is calculated recursively for all files under this path.

repo

string

"hello_world"

The repository name of the space (e.g., 'hello_world', 'chatbot').

namespace

string

"gradio"

The namespace or organization name that owns the space (e.g., 'gradio', 'huggingface').


Hugging Face Get Spaces Xet Read Token

Integration name: HUGGING_FACE_GET_SPACES_XET_READ_TOKEN

Tool to retrieve a short-lived XET read access token for a Hugging Face Space repository. Use when you need to access XET (eXtensible Tensor) data for a specific Space revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch, tag, or commit hash) to get the XET read token for. Common values include 'main', 'master', or specific commit hashes.

repo

string

"Ace-Step-v1.5"

The repository name of the Space. For example, 'Ace-Step-v1.5' in 'ACE-Step/Ace-Step-v1.5'.

namespace

string

"ACE-Step"

The namespace (organization or user) that owns the Space repository. For example, 'ACE-Step' in 'ACE-Step/Ace-Step-v1.5'.


Hugging Face Get Spaces Xet Write Token

Integration name: HUGGING_FACE_GET_SPACES_XET_WRITE_TOKEN

Tool to retrieve a short-lived XET write access token for a Hugging Face space repository. Use when you need to upload or write XET data to a specific space revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The revision (branch, tag, or commit hash) to get the XET write token for. Common values include 'main', 'master', or specific commit hashes.

repo

string

"ComfyUI"

The repository name of the space. For example, 'ComfyUI' in 'SpacesExamples/ComfyUI'.

create_pr

integer

1

Pass 1 to enable PR creation mode for users without direct write access to the repository. When set, changes will be submitted as a pull request instead of direct commits.

namespace

string

"SpacesExamples"

The namespace (organization or user) that owns the space repository. For example, 'SpacesExamples' in 'SpacesExamples/ComfyUI'.


Integration name: HUGGING_FACE_GET_TRENDING

Tool to retrieve trending repositories from Hugging Face. Use when you need to discover popular models, datasets, or spaces that are currently trending on the platform.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

type

string

"all"

Repository type filter for trending repositories.

limit

integer

10

Maximum number of trending repositories to return. Defaults to 10.


Hugging Face Get Users Avatar

Integration name: HUGGING_FACE_GET_USERS_AVATAR

Tool to retrieve the avatar URL for a Hugging Face user. Use when you need to get the avatar image URL for a specific user.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

redirect

string

"true"

If provided, redirect to the avatar URL instead of returning it as JSON. Set to any value to enable redirection.

username

string

"julien-c"

The username of the user whose avatar URL to retrieve. For example, 'julien-c' or 'lysandre'.


Hugging Face Get Users Overview

Integration name: HUGGING_FACE_GET_USERS_OVERVIEW

Tool to retrieve a comprehensive overview of a Hugging Face user's profile. Use when you need to get user statistics, organizations, activity counts, and profile information.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

username

string

"yjernite"

Username of the Hugging Face user to retrieve overview for. This is the user's handle on Hugging Face.


Hugging Face Get Users Socials

Integration name: HUGGING_FACE_GET_USERS_SOCIALS

Tool to retrieve a user's social media handles from Hugging Face. Use when you need to find a user's GitHub, LinkedIn, Twitter/X, or Bluesky profiles. Only returns handles that the user has publicly shared on their Hugging Face profile.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

username

string

"julien-c"

The username of the Hugging Face user to retrieve social media handles for. This is the user's username on Hugging Face.


Hugging Face Get Whoami

Integration name: HUGGING_FACE_GET_WHOAMI

Tool to get information about the authenticated Hugging Face user including username, email, organizations, and token details. Use when you need to identify the current user from an access token or retrieve user profile information.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face Handle Datasets User Access Request

Integration name: HUGGING_FACE_HANDLE_DATASETS_USER_ACCESS_REQUEST

Tool to handle a user's access request to a gated Hugging Face dataset. Use this to accept, reject, or update the status of access requests for repositories with gated access. Either 'user' or 'userId' must be provided to identify the user.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"test-gated-dataset-cancel"

The repository name of the gated dataset. For example, 'test-gated-dataset-cancel'.

user

string

"julien-c"

The username of the user whose access request is being handled. Either 'user' or 'userId' must be provided, but not both.

status

string

"accepted"

The decision on the access request. Use 'accepted' to grant access, 'rejected' to deny access, or 'pending' to keep the request pending.

userId

string

"507f1f77bcf86cd799439011"

The user ID (24-character hexadecimal string) of the user whose access request is being handled. Either 'user' or 'userId' must be provided, but not both.

namespace

string

"121tester"

The namespace (organization or user) that owns the dataset. For example, '121tester' or 'huggingface'.

rejectionReason

string

"Does not meet repository requirements"

The reason for rejecting the access request. Maximum 200 characters. Only applicable when status is 'rejected'.


Hugging Face List Collections

Integration name: HUGGING_FACE_LIST_COLLECTIONS

Tool to list collections on the Hugging Face Hub. Use when you need to discover collections of models, datasets, spaces, or papers. Collections are curated groups of repositories organized by users.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

q

string

"machine learning"

Search query to filter collections by title or description. Use keywords to find relevant collections.

item

string

"jbilcke-hf/ai-comic-factory"

Filter collections by item ID (repo_id, paper id, or collection slug). Use this to find collections containing a specific item.

sort

string

"trending"

Enum for sorting options for collections.

limit

integer

5

Maximum number of collections to return per page. Defaults to 10.

owner

string

"TheBloke"

Filter collections by owner username. Use this to get collections created by a specific user or organization.

cursor

string

Pagination cursor for fetching the next page of results. Use the cursor from the previous response to get more collections.

expand

string

Comma-separated list of fields to expand in the response. Use this to get additional details about collections.


Hugging Face List Dataset Parquet Files

Integration name: HUGGING_FACE_LIST_DATASET_PARQUET_FILES

Tool to get the list of Parquet files for a dataset. Use when you need to download or access dataset files in Parquet format. Returns URLs to download Parquet files with metadata about splits, configurations, and file sizes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

dataset

string

"rajpurkar/squad"

Name of the dataset to get Parquet files for. Format: 'namespace/repo-name' (e.g., 'rajpurkar/squad', 'huggingface/cifar10').


Hugging Face List Dataset Paths Info

Integration name: HUGGING_FACE_LIST_DATASET_PATHS_INFO

Tool to list detailed information about specific paths in a Hugging Face dataset repository. Use when you need to get metadata about files or directories in a dataset, including size, type, commit history, and security scan status.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

Git revision (branch, tag, or commit hash) to query

repo

string

"glue"

Dataset repository name

paths

["README.md",".gitattributes"]

List of paths to get information about, or a single path string. Paths are relative to the repository root.

expand

true

Whether to expand the response with last commit and security file status information. Can be a boolean or an object with expansion options.

namespace

string

"nyu-mll"

Namespace (user or organization) that owns the dataset


Hugging Face List Datasets

Integration name: HUGGING_FACE_LIST_DATASETS

Tool to list datasets on the Hugging Face Hub. Use when you need to discover or search for datasets. Supports filtering by author, search query, tags, and sorting by various properties.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

sort

string

"trending"

Enum for sorting properties.

limit

integer

10

Limit the number of datasets returned. Defaults to 100 if not specified.

author

string

"huggingface"

Filter datasets by an author or organization. Use this to get datasets from a specific user or org.

cursor

string

Pagination cursor for fetching the next page of results. Use the next_cursor value from a previous response.

filter

string

"task_categories:text-generation"

Filter based on tags. Use this to find datasets with specific tags like task types, languages, or licenses.

search

string

"wikipedia"

Filter based on substrings for dataset names and their usernames. Use this to search for datasets by keyword.

direction

string

"desc"

Enum for sort direction.


Hugging Face List Datasets Commits

Integration name: HUGGING_FACE_LIST_DATASETS_COMMITS

Tool to list commits from a Hugging Face dataset repository. Use when you need to retrieve the commit history for a specific dataset branch or revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination. Starts from 0 for the first page.

rev

string

"main"

The revision (branch, tag, or commit hash) to list commits from.

repo

string

"squad"

The repository name of the dataset.

limit

integer

10

Maximum number of commits to return per page. Default is 50.

namespace

string

"rajpurkar"

The namespace (username or organization) that owns the dataset.


Hugging Face List Dataset Splits

Integration name: HUGGING_FACE_LIST_DATASET_SPLITS

Tool to get the list of subsets and splits of a dataset. Returns the available configurations and splits for a given dataset on the Hub. Use when you need to understand the structure of a dataset before querying specific splits.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

dataset

string

"stanfordnlp/imdb"

Name of the dataset to retrieve splits for. Format: 'namespace/repo-name' (e.g., 'stanfordnlp/imdb', 'huggingface/squad').


Hugging Face List Datasets Refs

Integration name: HUGGING_FACE_LIST_DATASETS_REFS

Tool to list all references (branches, tags, converts, pull requests) in a Hugging Face dataset repository. Use when you need to retrieve available references for a specific dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"imdb"

The repository name of the dataset.

namespace

string

"stanfordnlp"

The namespace (organization or user) that owns the dataset.

include_prs

boolean

Whether to include pull requests in the response. Set to true to include pull requests.


Hugging Face List Datasets User Access Request

Integration name: HUGGING_FACE_LIST_DATASETS_USER_ACCESS_REQUEST

Tool to list access requests for a gated Hugging Face dataset repository. Use when you need to view pending, accepted, or rejected access requests for datasets with restricted access.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"test-gated-dataset-cancel"

The repository name of the gated dataset

after

string

Cursor for pagination - returns requests after this cursor

limit

integer

100

Maximum number of access requests to return (default: 1000)

before

string

Cursor for pagination - returns requests before this cursor

status

string

Filter access requests by status: pending, accepted, or rejected

namespace

string

"121tester"

The namespace or organization name that owns the dataset


Hugging Face List Discussions

Integration name: HUGGING_FACE_LIST_DISCUSSIONS

Tool to list discussions for a Hugging Face repository. Use when you need to retrieve discussions or pull requests for a specific model, dataset, or space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination. Starts from 0 for the first page.

repo

string

"opt-125m"

The repository name to list discussions from.

sort

string

Sort type enum.

type

string

Discussion type enum.

author

string

"john_doe"

Filter discussions by author username.

search

string

"bug"

Search query to filter discussions by title or content.

status

string

Discussion status enum.

namespace

string

"facebook"

The namespace (username or organization) that owns the repository.

repo_type

string

"models"

Type of repository to list discussions from: models, spaces, or datasets.


Hugging Face List Docs

Integration name: HUGGING_FACE_LIST_DOCS

Tool to retrieve the list of available documentation from Hugging Face. Use when you need to discover available documentation resources.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face List Endpoints

Integration name: HUGGING_FACE_LIST_ENDPOINTS

Tool to list Hugging Face Inference Endpoints for a specific user or organization. Use when you need to retrieve endpoints, optionally filtered by tags or name.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

tags

string

"tag1,tag2"

Filter endpoints by tags (comma-separated). Use this to find endpoints with specific tags.

limit

integer

10

Maximum number of endpoints to return per page. Defaults to 20 if not specified.

cursor

string

"3"

Pagination cursor to fetch the next or previous page of results. Use the nextCursor or prevCursor from the previous response.

search

string

"qwen"

Filter endpoints by name substring. Use this to search for endpoints containing specific text in their name.

namespace

string

"johnDoe"

User or organization name to list endpoints for. This is the owner of the endpoints you want to retrieve.


Hugging Face List Models Commits

Integration name: HUGGING_FACE_LIST_MODELS_COMMITS

Tool to list commits from a Hugging Face model repository. Use when you need to retrieve the commit history for a specific model branch or revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination. Starts from 0 for the first page.

rev

string

"main"

The revision (branch, tag, or commit hash) to list commits from.

repo

string

"gpt2"

The repository name of the model.

limit

integer

10

Maximum number of commits to return per page. Default is 50.

expand

array

["formatted"]

List of fields to expand in the response. Use 'formatted' to include formatted commit messages.

namespace

string

"openai-community"

The namespace (username or organization) that owns the model.


Hugging Face List Models Paths Info

Integration name: HUGGING_FACE_LIST_MODELS_PATHS_INFO

Tool to list detailed information about specific paths in a Hugging Face model repository. Use when you need to get metadata about files or directories in a model, including size, type, commit history, and security scan status.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

Git revision (branch, tag, or commit hash) to query

repo

string

"bert-base-uncased"

Model repository name

paths

["config.json","pytorch_model.bin"]

List of paths to get information about, or a single path string. Paths are relative to the repository root.

expand

true

Whether to expand the response with last commit and security file status information. Can be a boolean or an object with expansion options.

namespace

string

"google-bert"

Namespace (user or organization) that owns the model


Hugging Face List Models Refs

Integration name: HUGGING_FACE_LIST_MODELS_REFS

Tool to list all references (branches, tags, converts, and optionally pull requests) in a Hugging Face model repository. Use when you need to retrieve version control information for a specific model.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"bert-base-uncased"

Repository name within the namespace (e.g., 'bert-base-uncased')

namespace

string

"google-bert"

Namespace or organization name (e.g., 'google-bert', 'facebook')

include_prs

boolean

Whether to include pull requests in the response. Defaults to false.


Hugging Face List Notifications

Integration name: HUGGING_FACE_LIST_NOTIFICATIONS

Tool to list notifications for the authenticated Hugging Face user. Use when you need to retrieve user notifications, optionally filtered by read status, repository type, author, or other criteria.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination. Defaults to 0.

mention

string

"all"

Enum for mention filter.

paperId

string

"2103.00020"

Filter notifications by paper ID.

repoName

string

"transformers"

Filter notifications by repository name.

repoType

string

"model"

Enum for repository type filter.

articleId

string

"article123"

Filter notifications by article ID.

lastUpdate

string

"2024-01-01T00:00:00Z"

Filter notifications by last update timestamp.

postAuthor

string

"username"

Filter notifications by the author of the post.

readStatus

string

"all"

Enum for notification read status filter.


Hugging Face List Repo Files

Integration name: HUGGING_FACE_LIST_REPO_FILES

Tool to get the file tree of a Hugging Face repository with pagination support. Use when you need to browse files and folders in any repository type (model, dataset, or space), explore repository structure, or discover available files.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

path

string

""

Path within the repository to list. Use empty string or '.' for root directory. Supports nested paths.

limit

integer

10

Maximum number of items to return. Defaults to 1000, or 100 when expand=true. Use with cursor for pagination.

cursor

string

"eyJwYXRoIjoiZmlsZS50eHQifQ=="

Pagination cursor from a previous response to fetch the next page of results. Omit for the first page.

expand

boolean

true

If true, returns associated commit data for each entry and security scanner metadata. Defaults to false if not specified.

repo_id

string

"google-bert/bert-base-uncased"

Repository ID in the format author/repo-name. Example: 'google-bert/bert-base-uncased' for a model.

revision

string

"main"

Git revision (branch, tag, or commit SHA) to list. Use 'main' for default branch.

recursive

boolean

true

If true, returns the tree recursively including all subdirectories. Defaults to false if not specified.

repo_type

string

"model"

Repository type: model, dataset, or space.


Hugging Face List Settings Webhooks

Integration name: HUGGING_FACE_LIST_SETTINGS_WEBHOOKS

Tool to list all webhooks configured in Hugging Face settings. Use when you need to retrieve webhook configurations for the authenticated user's account.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face List Spaces

Integration name: HUGGING_FACE_LIST_SPACES

Tool to list Spaces on the Hugging Face Hub with filtering options. Use when you need to discover or search for ML demo applications hosted on Hugging Face.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

sort

string

"lastModified"

Property to use when sorting results. Common values include 'lastModified', 'likes', 'trending', or 'created'.

limit

integer

5

Maximum number of spaces to return in the response. Must be between 1 and 500.

author

string

"huggingface"

Filter spaces by a specific author or organization name.

filter

string

"gradio"

Filter based on tags. You can specify tags to find spaces by SDK type (e.g., 'gradio', 'streamlit'), task type, or other characteristics.

search

string

"gradio"

Filter based on substrings for repos and their usernames. Use to search for specific space names or authors.

direction

string

"-1"

Direction in which to sort results. Use '1' for ascending order or '-1' for descending order. Must be used together with the sort parameter.


Hugging Face List Spaces Commits

Integration name: HUGGING_FACE_LIST_SPACES_COMMITS

Tool to list commits from a Hugging Face Space repository. Use when you need to retrieve the commit history for a specific Space branch or revision.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

p

integer

0

Page number for pagination. Starts from 0 for the first page.

rev

string

"main"

The revision (branch, tag, or commit hash) to list commits from.

repo

string

"Qwen3-TTS"

The repository name of the Space.

limit

integer

10

Maximum number of commits to return per page. Default is 50.

expand

array

["formatted"]

List of fields to expand in the response. Use 'formatted' to include formatted commit messages.

namespace

string

"Qwen"

The namespace (username or organization) that owns the Space.


Hugging Face List Spaces Hardware

Integration name: HUGGING_FACE_LIST_SPACES_HARDWARE

Tool to retrieve available hardware configurations for Hugging Face Spaces with their specifications and pricing. Use when you need to discover compute options for running spaces.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face List Spaces Lfs Files

Integration name: HUGGING_FACE_LIST_SPACES_LFS_FILES

Tool to list LFS (Large File Storage) files from a Hugging Face Space repository. Use when you need to retrieve large files stored in a Space using Git LFS.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

xet

string

"true"

Filter for Xet-specific files. Used for Xet-enabled repositories.

repo

string

"test-curl-space"

The repository name of the Space.

limit

integer

100

Maximum number of LFS files to return. Default is 1000.

cursor

string

"eyJmaWxlT2lkIjoiYWJjMTIzIn0"

Cursor for pagination. Use the cursor returned from a previous request to fetch the next page of results.

namespace

string

"121tester"

The namespace (username or organization) that owns the Space.


Hugging Face List Spaces Paths Info

Integration name: HUGGING_FACE_LIST_SPACES_PATHS_INFO

Tool to list detailed information about specific paths in a Hugging Face space repository. Use when you need to get metadata about files or directories in a space, including size, type, commit history, and security scan status.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

Git revision (branch, tag, or commit hash) to query

repo

string

"hello_world"

Space repository name

paths

["README.md","app.py"]

List of paths to get information about, or a single path string. Paths are relative to the repository root.

expand

true

Whether to expand the response with last commit and security file status information. Can be a boolean or an object with expansion options.

namespace

string

"gradio"

Namespace (user or organization) that owns the space


Hugging Face List Spaces Refs

Integration name: HUGGING_FACE_LIST_SPACES_REFS

Tool to list all references (branches, tags, converts, pull requests) in a Hugging Face space repository. Use when you need to retrieve available references for a specific space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"chatbot"

The repository name of the space.

namespace

string

"gradio"

The namespace (organization or user) that owns the space.

include_prs

boolean

Whether to include pull requests in the response. Set to true to include pull requests.


Hugging Face List Vendors

Integration name: HUGGING_FACE_LIST_VENDORS

Tool to list available cloud provider vendors for Hugging Face Inference Endpoints. Use when you need to discover available infrastructure options across AWS, Azure, and GCP. Returns vendors with their regions and compute instance types for deploying models.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Hugging Face Search Dataset

Integration name: HUGGING_FACE_SEARCH_DATASET

Tool to search text in a dataset split on Hugging Face. Searches in columns of type string, even if values are nested in a dictionary. Use when you need to find specific text or patterns within a dataset's content. Returns matching rows with their data.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

query

string

"great"

Text to search for in the dataset. Searches in all columns of type string, even if values are nested in a dictionary.

split

string

"train"

Name of the dataset split to search.

config

string

"default"

Name of the configuration/subset of the dataset to search.

length

integer

5

Length of the slice (number of rows to return). Maximum value is 100. Defaults to API default if not specified.

offset

integer

0

Offset of the slice for pagination. Specifies the starting position in the results. Defaults to 0 if not specified.

dataset

string

"cornell-movie-review-data/rotten_tomatoes"

Name of the dataset to search. Use format 'owner/dataset-name' for user datasets or just 'dataset-name' for official datasets.


Hugging Face Search Docs

Integration name: HUGGING_FACE_SEARCH_DOCS

Tool to search Hugging Face documentation across all products and libraries. Use when you need to find information about HF tools, models, datasets, or API usage.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

q

string

"transformers"

Search query string to find relevant documentation pages. Use keywords related to the topic you want to learn about.

limit

integer

5

Maximum number of search results to return. Defaults to 10.

offset

integer

0

Number of results to skip for pagination. Use with limit to page through results. For example, offset=10 with limit=10 returns results 11-20.

product

string

"transformers"

Enum for Hugging Face product types to search documentation.


Hugging Face Search Papers

Integration name: HUGGING_FACE_SEARCH_PAPERS

Tool to perform hybrid semantic/full-text search on papers in Hugging Face. Use when you need to find research papers by keywords, topics, or authors.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

q

string

"transformer"

Search query string to find relevant papers. Use keywords, paper titles, or topics. Supports hybrid semantic and full-text search.

limit

integer

5

Maximum number of papers to return. If not specified, the API will use its default limit.


Hugging Face Squash Dataset Commits

Integration name: HUGGING_FACE_SQUASH_DATASET_COMMITS

Tool to squash all commits in a dataset ref into a single commit with the given message. Use when consolidating commit history into a single commit. WARNING: This operation is irreversible.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"test-super-squash"

The ref (branch or revision) to squash. This operation is irreversible and will squash all commits in this ref into a single commit.

repo

string

"test-discussion-dataset"

The name of the dataset repository to squash commits in.

message

string

"Squashed all commits for testing purposes"

The commit message for the squashed commit. Maximum length is 500 characters.

namespace

string

"121tester"

The namespace (organization or user) that owns the dataset.


Hugging Face Squash Spaces Commits

Integration name: HUGGING_FACE_SQUASH_SPACES_COMMITS

Tool to squash all commits in a space ref into a single commit with the given message. Use when consolidating commit history into a single commit. WARNING: This operation is irreversible.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

rev

string

"main"

The ref (branch or revision) to squash. This operation is irreversible and will squash all commits in this ref into a single commit. Typically 'main' or a branch name.

repo

string

"test-curl-space"

The name of the space repository where commits will be squashed. For example, for space '121tester/test-curl-space', the repo is 'test-curl-space'.

message

string

"Squashed all commits into one"

The commit message for the squashed commit. Maximum length is 500 characters. If not provided, a default message will be used.

namespace

string

"121tester"

The namespace (username or organization) that owns the space repository. For example, for space '121tester/test-curl-space', the namespace is '121tester'.


Hugging Face Update Datasets Settings

Integration name: HUGGING_FACE_UPDATE_DATASETS_SETTINGS

Tool to update settings for a Hugging Face dataset repository. Use when you need to configure visibility, discussions, gating, or access control for a dataset.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"test-discussion-dataset"

The name of the dataset repository

gated

Gating configuration for the dataset. Controls access restrictions and gating behavior. Can be a boolean to enable/disable gating, or an object with gating configuration

private

boolean

false

Whether the dataset is private. Set to true to make private, false to make public

namespace

string

"121tester"

The namespace (organization or username) that owns the dataset

discussions_sorting

string

"recently-created"

Enum for discussion sorting options.

discussions_disabled

boolean

false

Whether discussions are disabled for this dataset. Set to true to disable discussions, false to enable them

gated_notifications_mode

string

"bulk"

Enum for gated notification modes.

gated_notifications_email

string

"admin@example.com"

Email address to receive notifications about gated access requests. Must be a valid email format


Hugging Face Update Discussions Title

Integration name: HUGGING_FACE_UPDATE_DISCUSSIONS_TITLE

Tool to change the title of an existing discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to update or correct a discussion's title.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

num

string

"141"

The discussion number/identifier to update the title for.

repo

string

"gpt2"

The name of the repository where the discussion is located.

title

string

"Updated Test Discussion Title"

The new title for the discussion. Must be between 3 and 200 characters.

namespace

string

"openai-community"

The namespace (username or organization) that owns the repository.

repo_type

string

"models"

The type of repository: models, spaces, or datasets. This determines where the discussion is located.


Hugging Face Update Models Settings

Integration name: HUGGING_FACE_UPDATE_MODELS_SETTINGS

Tool to update settings for a Hugging Face model repository. Use when you need to modify repository configuration such as privacy, discussions, or gated access settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"test-tag-creation-model"

The name of the model repository to update settings for.

private

boolean

false

Whether the model repository should be private (requires authentication to access) or public.

namespace

string

"121tester"

The namespace (username or organization) that owns the model repository.

discussionsSorting

string

"recently-created"

Sorting order for discussions.

discussionsDisabled

boolean

false

Whether to disable discussions for this model repository. Set to true to disable, false to enable.

gatedNotificationsMode

string

"bulk"

Notification mode for gated access requests.

gatedNotificationsEmail

string

"admin@example.com"

Email address to receive notifications about gated access requests. Must be a valid email format.


Hugging Face Update Settings Notifications

Integration name: HUGGING_FACE_UPDATE_SETTINGS_NOTIFICATIONS

Tool to update notification settings for the authenticated Hugging Face user. Use when you need to enable or disable various notification types such as announcements, discussions, paper digests, or product updates.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

notifications

object

Notification settings to update. Only include the specific notification preferences you want to change.

prepaidAmount

string

"$100"

Prepaid amount to be provided when enabling launch_prepaid_credits notification. Maximum length is 24 characters.


Hugging Face Update Settings Watch

Integration name: HUGGING_FACE_UPDATE_SETTINGS_WATCH

Tool to update watch settings for your Hugging Face account. Use when you want to get notified about discussions on organizations, users, or repositories. You can add new items to watch and/or remove items from your watch list in a single request.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

add

array

[{"id":"huggingface","type":"org"}]

Array of items to start watching. Each item must specify an 'id' and 'type'. You will receive notifications when discussions happen on these items. Leave empty if you only want to remove items from watch list.

delete

array

[{"id":"old-user","type":"user"}]

Array of items to stop watching. Each item must specify an 'id' and 'type'. You will no longer receive notifications for discussions on these items. Leave empty if you only want to add items to watch list.


Hugging Face Update Settings Webhooks

Integration name: HUGGING_FACE_UPDATE_SETTINGS_WEBHOOKS

Tool to update an existing webhook in Hugging Face settings. Use when you need to modify webhook configuration such as watched entities, event domains, target URL, or job settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

job

object

Model for webhook job configuration to execute when webhook triggers.

url

string

"https://webhook.site/updated-test-webhook"

URL endpoint where webhook POST requests will be sent when events occur. Must be a valid HTTP/HTTPS URL.

secret

string

"my-secret-key-123"

Secret string used to sign webhook requests for verification. Must contain only printable ASCII characters.

domains

array

["repo"]

List of event domains that trigger the webhook. At least one domain is required. 'repo' for repository events, 'discussion' for discussion events.

watched

array

[{"name":"test-user","type":"user"}]

List of entities to watch (users, organizations, or repositories). At least one item is required. Events from these entities will trigger the webhook.

webhookId

string

"69497316e950b2fad95060df"

The unique identifier of the webhook to update (24-character hexadecimal string). Get this from the list webhooks action.

jobSourceId

string

"source-123"

Source identifier for the job. Used to track the origin of the job execution.


Hugging Face Update Spaces Settings

Integration name: HUGGING_FACE_UPDATE_SPACES_SETTINGS

Tool to update settings for a Hugging Face Spaces repository. Use when you need to modify repository configuration such as privacy, discussions, or gated access settings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

repo

string

"test-curl-space"

The name of the Spaces repository to update settings for.

gated

Gating configuration for the Spaces repository. Controls access restrictions and gating behavior. Can be a boolean to enable/disable gating, or an object with gating configuration.

private

boolean

false

Whether the Spaces repository should be private (requires authentication to access) or public.

namespace

string

"121tester"

The namespace (organization or username) that owns the Spaces repository.

discussionsSorting

string

"recently-created"

Sorting order for discussions.

discussionsDisabled

boolean

false

Whether to disable discussions for this Spaces repository. Set to true to disable, false to enable.

gatedNotificationsMode

string

"bulk"

Notification mode for gated access requests.

gatedNotificationsEmail

string

"admin@example.com"

Email address to receive notifications about gated access requests. Must be a valid email format.


Hugging Face Update Sql Console Embed

Integration name: HUGGING_FACE_UPDATE_SQL_CONSOLE_EMBED

Tool to update an existing SQL console embed for a Hugging Face dataset. Use when you need to modify the SQL query, title, or privacy settings of an existing embed.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"UL_7SQR"

The slug identifier of the SQL console embed to update (not the _id). This is returned as 'slug' when creating an embed

sql

string

"SELECT * FROM train LIMIT 100"

The SQL query string to execute in the console embed

repo

string

"test-discussion-dataset"

The name of the dataset repository

title

string

"Fully Updated SQL Query"

The title of the SQL console embed. Maximum 200 characters

private

boolean

true

Whether the SQL console embed is private. Set to true to make it private, false to make it public

namespace

string

"121tester"

The namespace (username or organization) that owns the dataset repository

repo_type

string

"datasets"

The type of repository. Currently only 'datasets' is supported


Hugging Face Update Webhook Status

Integration name: HUGGING_FACE_UPDATE_WEBHOOK_STATUS

Tool to enable or disable a webhook on Hugging Face. Use when you need to temporarily deactivate a webhook without deleting it, or reactivate a previously disabled webhook.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

action

string

"disable"

The action to perform on the webhook: 'enable' to activate the webhook or 'disable' to deactivate it.

webhookId

string

"69497316e950b2fad95060df"

The unique identifier of the webhook to enable or disable. Must be a 24-character hexadecimal string.