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:
huggingface-cli 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
1 maintainer
Metadata
1 maintainer
Release files for hf-inference-acp 0.10.46
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 | |
|---|---|---|---|---|
| hf_inference_acp-0.10.46.tar.gz | 29.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hf_inference_acp-0.10.46-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 63.4 kB
Release files / hf_inference_acp-0.10.46.tar.gz
| Download URL | hf_inference_acp-0.10.46.tar.gz |
|---|---|
| Size | 29.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d6594cc876b98afb8f6b65c79d2514327917efb78be3c911ef764ff4f0ab9c69
|
|
BLAKE2b-256 checksum How to use checksums |
cb48b03242575929752036316b34ba7615dad60c75ec773c75c60c06e17705dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.46-py3-none-any.whl
| Download URL | hf_inference_acp-0.10.46-py3-none-any.whl |
|---|---|
| Size | 33.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6463a6fa8ef0138398fbdfe4d6bfb986ea573b8a967116598b79954c83f310f2
|
|
BLAKE2b-256 checksum How to use checksums |
b14f16bc2d3818b8f5aa3bf6796c5e41bf59362bb0d51d022b46b10d4ba9aa0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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.46
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.
