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
Release files for hf-inference-acp 0.10.33
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hf_inference_acp-0.10.33.tar.gz | 29.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hf_inference_acp-0.10.33-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 63.3 kB
Release files / hf_inference_acp-0.10.33.tar.gz
| Download URL | hf_inference_acp-0.10.33.tar.gz |
|---|---|
| Size | 29.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad88536a8b8428be6f1cc9f0b8c5e4c5fedcdef202732d243672c3d2ca5b9eda
|
|
BLAKE2b-256 checksum How to use checksums |
51c23b812b98d25eaf424763a26bd369772218c1b18932f1044e9fefcf62e651
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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.33-py3-none-any.whl
| Download URL | hf_inference_acp-0.10.33-py3-none-any.whl |
|---|---|
| Size | 33.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f97a6689dfe046dab74f5aef68e5c8e50beafd6f646235f00442adc60cc63c7
|
|
BLAKE2b-256 checksum How to use checksums |
2ed41e1129e31ebdd69935bd263cf846a4ba9c6fbd34e8fde29e7aa4dc20b270
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
