Files
promptfoo--promptfoo/examples/provider-replicate/quickstart
wehub-resource-sync 0d3cb498a3
Deploy local.promptfoo.app / Deploy to Cloudflare Pages (push) Waiting to run
Test and Publish Multi-arch Docker Image / test (push) Waiting to run
Test and Publish Multi-arch Docker Image / build-docker-and-push-digests (map[digest-suffix:linux-amd64 platform:linux/amd64 runner:ubuntu-latest]) (push) Blocked by required conditions
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) Blocked by required conditions
Test and Publish Multi-arch Docker Image / merge-docker-digests (push) Blocked by required conditions
Test and Publish Multi-arch Docker Image / Attest Multi-arch Image (push) Blocked by required conditions
Validate Renovate Config / Validate Renovate Configuration (push) Waiting to run
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
chore: import upstream snapshot with attribution
2026-07-13 13:24:08 +08:00
..

provider-replicate/quickstart (Replicate Quick Start)

You can run this example with:

npx promptfoo@latest init --example provider-replicate/quickstart
cd provider-replicate/quickstart

This is a minimal example to test the Replicate provider with promptfoo.

Quick Start

  1. Get a Replicate API token from https://replicate.com/account/api-tokens

  2. Set the environment variable:

    export REPLICATE_API_TOKEN=r8_your_token_here
    
  3. Run the evaluation:

    promptfoo eval
    

What This Tests

This example uses Replicate's "hello-world" model - a simple, fast model that's perfect for testing your setup. It:

  • Verifies your API key is working
  • Tests basic prompt templating
  • Demonstrates simple assertions
  • Runs quickly (< 5 seconds per test)

Next Steps

Once this works, try:

  1. Different Models: Replace the model ID with:

    • replicate:meta/meta-llama-3-8b-instruct - For text generation
    • replicate:image:stability-ai/sdxl:7762fd07cf82c948538e41f63f77d685e02b063e37e496e96eefd46c929f9bdc - For image generation (or use latest version from Replicate)
  2. More Examples: Check out:

    • provider-replicate/llama4-scout - Advanced text generation with Llama 4
    • provider-replicate/comprehensive - All provider features
    • provider-replicate/image-generation - State-of-the-art image generation

Troubleshooting

  • API Key Error: Make sure REPLICATE_API_TOKEN is set correctly
  • Model Not Found: Check the model ID matches one from https://replicate.com/explore
  • Timeout: Some models take 30-60 seconds on first run (cold start)