wehub-resource-sync
0d3cb498a3
CI / Shell Format Check (push) Has been cancelled
CI / Check Ruby (3.4) (push) Has been cancelled
CI / CI Config (push) Has been cancelled
CI / Test on Node ${{ matrix.node }} and ${{ matrix.os }}${{ matrix.shard && format(' (shard {0}/3)', matrix.shard) || '' }} (push) Has been cancelled
CI / Build on Node ${{ matrix.node }} (push) Has been cancelled
CI / Style Check (push) Has been cancelled
CI / Generate Assets (push) Has been cancelled
CI / Check Python (3.14) (push) Has been cancelled
CI / Check Python (3.9) (push) Has been cancelled
CI / Build Docs (push) Has been cancelled
CI / Code Scan Action (push) Has been cancelled
CI / Site tests (push) Has been cancelled
CI / webui tests (push) Has been cancelled
CI / Run Integration Tests (push) Has been cancelled
CI / Run Smoke Tests (push) Has been cancelled
CI / Go Tests (push) Has been cancelled
CI / Share Test (push) Has been cancelled
CI / Redteam (Production API) (push) Has been cancelled
CI / Redteam (Staging API) (push) Has been cancelled
CI / GitHub Actions Lint (push) Has been cancelled
CI / Check Ruby (3.0) (push) Has been cancelled
release-please / release-please (push) Has been cancelled
release-please / build (push) Has been cancelled
release-please / publish-npm (push) Has been cancelled
release-please / publish-npm-backfill (push) Has been cancelled
release-please / docker (push) Has been cancelled
release-please / publish-code-scan-action (push) Has been cancelled
release-please / attest-code-scan-action (push) Has been cancelled
Deploy local.promptfoo.app / Deploy to Cloudflare Pages (push) Has been cancelled
Test and Publish Multi-arch Docker Image / test (push) Has been cancelled
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-amd64 platform:linux/amd64 runner:ubuntu-latest]) (push) Has been cancelled
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-arm64 platform:linux/arm64 runner:ubuntu-24.04-arm]) (push) Has been cancelled
Test and Publish Multi-arch Docker Image / merge-docker-digests (push) Has been cancelled
Test and Publish Multi-arch Docker Image / Attest Multi-arch Image (push) Has been cancelled
Validate Renovate Config / Validate Renovate Configuration (push) Has been cancelled
75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# huggingface/chat (HuggingFace Chat Completions)
|
|
|
|
This example demonstrates how to use HuggingFace's OpenAI-compatible chat completions API with promptfoo.
|
|
|
|
## Setup
|
|
|
|
Set your HuggingFace token:
|
|
|
|
```bash
|
|
export HF_TOKEN=your_huggingface_token
|
|
```
|
|
|
|
Get your token from [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens). HuggingFace's router may incur usage costs depending on your plan and the model used.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
npx promptfoo@latest init --example huggingface/chat
|
|
npx promptfoo@latest eval
|
|
```
|
|
|
|
## Provider format
|
|
|
|
Use the `huggingface:chat` provider format:
|
|
|
|
```yaml
|
|
providers:
|
|
- id: huggingface:chat:meta-llama/Llama-3.3-70B-Instruct
|
|
config:
|
|
temperature: 0.1
|
|
max_new_tokens: 100
|
|
```
|
|
|
|
## Supported models
|
|
|
|
Any model available on HuggingFace's [Inference Providers](https://huggingface.co/docs/inference-providers/tasks/chat-completion) that supports chat completions:
|
|
|
|
- `deepseek-ai/DeepSeek-R1`
|
|
- `openai/gpt-oss-120b`
|
|
- `zai-org/GLM-4.5`
|
|
- `Qwen/Qwen2.5-Coder-32B-Instruct`
|
|
- `meta-llama/Llama-3.3-70B-Instruct`
|
|
- `google/gemma-3-27b-it`
|
|
- And many more...
|
|
|
|
Browse models at [huggingface.co/models?other=conversational](https://huggingface.co/models?other=conversational).
|
|
|
|
## Inference Provider routing
|
|
|
|
Some models require routing to a specific [Inference Provider](https://huggingface.co/docs/inference-providers). Use a `:provider` suffix or the `inferenceProvider` config option:
|
|
|
|
```yaml
|
|
providers:
|
|
# Provider suffix
|
|
- id: huggingface:chat:Qwen/QwQ-32B:featherless-ai
|
|
|
|
# Or config option
|
|
- id: huggingface:chat:Qwen/QwQ-32B
|
|
config:
|
|
inferenceProvider: featherless-ai
|
|
```
|
|
|
|
## Configuration options
|
|
|
|
| Parameter | Description |
|
|
| ------------------- | -------------------------------------- |
|
|
| `temperature` | Controls randomness (0.0-2.0) |
|
|
| `max_new_tokens` | Maximum tokens to generate |
|
|
| `top_p` | Nucleus sampling parameter |
|
|
| `inferenceProvider` | Route to a specific Inference Provider |
|
|
| `apiKey` | HuggingFace token (or use env) |
|
|
| `apiBaseUrl` | Custom API endpoint (optional) |
|
|
|
|
See [HuggingFace provider docs](/docs/providers/huggingface) for full configuration options.
|