Hugging Face inference agent with ACP support, powered by fast-agent-mcp
Project description
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 Claude Code).
Features
- Setup Mode: Configure HuggingFace credentials and model settings
- Hugging Face Mode: AI assistant powered by HuggingFace Inference API
- HuggingFace MCP Server: Built-in integration with HuggingFace'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.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hf_inference_acp-0.1.0.tar.gz.
File metadata
- Download URL: hf_inference_acp-0.1.0.tar.gz
- Upload date:
- Size: 22.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0511588e961913ddfc2125e6589162afde55be5db7e755e3fd41af41656e58ec
|
|
| MD5 |
02a1204eee5f2cf772c73a0401aec063
|
|
| BLAKE2b-256 |
7de9d2fd3e8cbde9104389ce8c8da5efe674835f7ee5c05ba0ee5e0f6ae51992
|
File details
Details for the file hf_inference_acp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: hf_inference_acp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f1c10c886ad75e264841ddfd3858762d5f924165250daeafa1510458c7fa3a00
|
|
| MD5 |
8e844b9084973d84a707d9707e467018
|
|
| BLAKE2b-256 |
e0fa563e32aa96aed884f4a5f6a708b5f703b73a5fabe3eef7de8b03633cd38f
|
