ai
Hugging Face CLI for Headless Automation
Use the Hugging Face CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Bearer token auth
Hugging Face CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Hugging Face CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Hugging Face CLI for Headless Automation
kosmokrator integrations:configure hugging-face --set access_token="$HUGGING_FACE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call hugging-face.huggingface_list_models '{"search":"example_search","author":"example_author","task":"example_task","tags":"example_tags","sort":"example_sort","direction":"example_direction","limit":1,"offset":1}' --jsonDiscovery Before Execution
Agents and scripts can inspect Hugging Face docs and schemas before choosing a function.
kosmo integrations:docs hugging-face --json
kosmo integrations:docs hugging-face.huggingface_list_models --json
kosmo integrations:schema hugging-face.huggingface_list_models --json
kosmo integrations:search "Hugging Face" --json
kosmo integrations:list --jsonUseful Hugging Face CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
hugging-face.huggingface_list_models | Read | search, author, task, tags, sort, direction, limit, offset | Search and list AI models on the Hugging Face Hub. Filter by text search, author, task (e.g. "text-generation", "image-classification"), tags, and sort by downloads, likes, or recent activity. |
hugging-face.huggingface_get_model | Read | model_id | Get detailed information about a specific Hugging Face model, including its card, tags, pipeline tag, library, downloads, likes, and file listing. |
hugging-face.huggingface_list_datasets | Read | search, author, tags, sort, direction, limit, offset | Search and list datasets on the Hugging Face Hub. Filter by text search, author, tags, and sort by downloads, likes, or recent activity. |
hugging-face.huggingface_inference | Write | model_id, inputs, parameters, data | Run inference on a Hugging Face model via the serverless Inference API. Supports text generation, summarization, translation, classification, image analysis, and more. The payload structure depends on the model's task — refer to the Hugging Face Inference API docs for model-specific formats. |
hugging-face.huggingface_list_spaces | Read | search, author, tags, sort, direction, limit, offset | Search and list Spaces on the Hugging Face Hub. Filter by text search, author, tags, SDK, and sort by downloads, likes, or recent activity. |
hugging-face.huggingface_get_current_user | Read | none | Get the authenticated Hugging Face user's profile information, including name, username, type (user/org), and avatar. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.