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
65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# provider-fal (fal.ai Image Generation Example)
|
|
|
|
You can run this example with:
|
|
|
|
```bash
|
|
npx promptfoo@latest init --example provider-fal
|
|
cd provider-fal
|
|
```
|
|
|
|
Demonstrates how to evaluate and compare image generation models using promptfoo.
|
|
|
|
## Setup
|
|
|
|
1. **Get your API key** from [fal.ai dashboard](https://fal.ai/dashboard/keys)
|
|
2. **Set environment variable**:
|
|
```bash
|
|
export FAL_KEY=your-fal-key-here
|
|
```
|
|
3. **Install client**:
|
|
```bash
|
|
npm install @fal-ai/client
|
|
```
|
|
4. **Run the evaluation**:
|
|
```bash
|
|
promptfoo eval
|
|
```
|
|
|
|
## What This Example Shows
|
|
|
|
- **Model comparison**: Two different fal.ai models side-by-side
|
|
- **Creative prompts**: 7 test cases with artistic styles
|
|
- **Reproducible results**: Fixed seeds for consistent outputs
|
|
- **Configuration options**: Different settings per model
|
|
|
|
## Example Output
|
|
|
|
The evaluation generates a comparison table showing:
|
|
|
|
- Model performance across different prompts
|
|
- Generated images in markdown format
|
|
- Execution time and caching behavior
|
|
|
|
## View Results
|
|
|
|
```bash
|
|
promptfoo view
|
|
```
|
|
|
|
Opens the web interface to browse generated images and compare model outputs.
|
|
|
|
## Customize the Example
|
|
|
|
Edit `promptfooconfig.yaml` to:
|
|
|
|
- Try different models from [fal.ai/models](https://fal.ai/models)
|
|
- Add your own prompts
|
|
- Adjust model parameters
|
|
- Add assertions to test output quality
|
|
- Route SDK requests through a proxy with `config.client.proxyUrl` when your environment requires it
|
|
|
|
## Documentation
|
|
|
|
- [promptfoo fal provider](https://promptfoo.dev/docs/providers/fal)
|
|
- [fal.ai models](https://fal.ai/models)
|