hf-inference-acp
Hugging Face inference agent with ACP (Agent Client Protocol) support, powered by fast-agent-mcp.
Installation
uvx hf-inference-acp
What is this?
This package provides an ACP-compatible agent for Hugging Face Inference API. It allows you to use Hugging Face's Inference Providers through any ACP-compatible client (like Toad).
ACP sessions are always connection-scoped.
Features
- Setup Mode: Configure Hugging Face credentials and model settings
- Hugging Face Mode: AI assistant powered by Hugging Face Inference API
- HuggingFace MCP Server: Built-in integration with Hugging Face's MCP server for accessing models, datasets, and spaces
Quick Start
-
Run the agent:
uvx hf-inference-acp -
If
HF_TOKENis not set, you'll start in Setup mode with these commands:/login- Get instructions for HuggingFace authentication/set-model <model>- Set the default model/check- Verify your configuration
-
Once authenticated (HF_TOKEN is set), you'll automatically start in Hugging Face mode.
-
In Hugging Face mode, use
/connectto connect to the Hugging Face MCP server for model/dataset search tools.
Curated Model Aliases
/set-model supports short aliases from fast-agent's curated Hugging Face list, including:
kimiglmminimaxdeepseek4prokimi25(thinking profile)qwen35(thinking profile)qwen35instruct(instruct profile)
Kimi 2.5 aliases resolve to hf.moonshotai/Kimi-K2.5:fireworks-ai with curated defaults:
kimi25:temperature=1.0, top_p=0.95
Qwen 3.5 aliases resolve to hf.Qwen/Qwen3.5-397B-A17B:novita with curated sampling defaults:
qwen35:temperature=0.6, top_p=0.95, top_k=20, min_p=0.0, presence_penalty=0.0, repetition_penalty=1.0qwen35instruct:temperature=0.7, top_p=0.8, top_k=20, min_p=0.0, presence_penalty=1.5, repetition_penalty=1.0
Configuration
Configuration is stored at ~/.config/hf-inference/hf.config.yaml:
default_model: hf.moonshotai/Kimi-K2-Instruct-0905
mcp:
servers:
huggingface:
url: "https://huggingface.co/mcp?login"
Authentication
Set your HuggingFace token using one of these methods:
-
Environment variable:
export HF_TOKEN=your_token_here
-
HuggingFace CLI:
hf auth login
Get your token from: https://huggingface.co/settings/tokens
License
Apache License 2.0 - See the main repository for details.
More Information
For full documentation and the main project, visit: https://github.com/evalstate/fast-agent
Metadata
Release files for hf-inference-acp 0.10.49
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hf_inference_acp-0.10.49.tar.gz | 29.7 kB | Without provenance | Details for hf_inference_acp-0.10.49.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hf_inference_acp-0.10.49-py3-none-any.whl | Python 3 | none | any | Details for hf_inference_acp-0.10.49-py3-none-any.whl |
Total release size: 63.3 kB
Release files / hf_inference_acp-0.10.49.tar.gz
| Download URL | hf_inference_acp-0.10.49.tar.gz |
|---|---|
| Size | 29.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8885a3ead1b3d227dedc683b91c169367565de21797e41664405d6991fbd58c
|
|
BLAKE2b-256 checksum How to use checksums |
6fa53c669b0fbb392d358dd9de69e801bceb9b80f48898d9397508c704175eb5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / hf_inference_acp-0.10.49-py3-none-any.whl
| Download URL | hf_inference_acp-0.10.49-py3-none-any.whl |
|---|---|
| Size | 33.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5b2af422d21ef862e8d964cd68f88723590cf88dd7735c217c0597a285b6d1b3
|
|
BLAKE2b-256 checksum How to use checksums |
3d2e1d3d417e6d36d7fa23e01e25be8ea743b1fdb1992e103602c1bf78be7ec8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for hf-inference-acp 0.10.49
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.