Skip to main content

​
Agents

Use Opper as an inference provider for your agent framework, editor, or SDK of choice. All integrations give you access to the full Opper model catalog, including EU-hosted options via AWS EU, Evroc, and Berget.
Run npx @opperai/setup to set up OpenCode and Continue.dev automatically.

OpenCode

Terminal-based AI coding assistant

Vercel AI SDK

Use any Opper model with the Vercel AI SDK

OpenClaw

Personal AI assistant powered by pi

pi

Terminal coding agent with native Opper provider support

Hermes

Open-source terminal agent via custom OpenAI-compatible endpoint

Cursor

AI-powered code editor with rules support

Cline

VS Code extension with OpenAI-compatible providers

Continue.dev

Open-source AI assistant for VS Code and JetBrains

​
OpenCode

OpenCode is a terminal-based AI coding assistant. Run npx @opperai/setup and select OpenCode, or set it up manually: 
mkdir -p ~/.config/opencode
curl -o ~/.config/opencode/opencode.json https://raw.githubusercontent.com/opper-ai/setup/main/data/opencode.json
export OPPER_API_KEY=your-api-key

​
Vercel AI SDK

The Vercel AI SDK is a TypeScript toolkit for building AI-powered applications. Install the Opper provider package and pass any Opper model string to generateText, streamText, embed, or tool calls: 
npm install @opperai/ai-sdk-provider ai

import { opper } from '@opperai/ai-sdk-provider';
import { generateText } from 'ai';

const { text } = await generateText({
  model: opper('openai/gpt-4o'),
  prompt: 'Hello!',
});
Pass any Opper model string: opper('anthropic/claude-sonnet-4-5'), opper('google/gemini-2.0-flash'), opper('default'), etc. Session tracing: Wrap your model with opperSpan to group all calls in a conversation under a single trace in Opper: 
import { wrapLanguageModel, generateText } from 'ai';
import { opper, opperSpan } from '@opperai/ai-sdk-provider';

const { middleware, handle } = opperSpan({ name: 'my-chat-session' });

const model = wrapLanguageModel({
  model: opper('openai/gpt-4o'),
  middleware,
});

const { text } = await generateText({ model, prompt: 'Hello!' });
await handle.end(text); // closes the span

​
OpenClaw

OpenClaw is a personal AI assistant built on pi that runs on WhatsApp, Telegram, Discord, and other chat apps. Add Opper as a custom provider in ~/.openclaw/config.json: 
{
  "env": { "OPPER_API_KEY": "your-api-key" },
  "agents": {
    "defaults": {
      "model": { "primary": "opper/anthropic/claude-opus-4" }
    }
  },
  "models": {
    "providers": {
      "opper": {
        "baseUrl": "https://api.opper.ai/v3/compat",
        "apiKey": "${OPPER_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "anthropic/claude-opus-4", "name": "Claude Opus 4 (Opper)" },
          { "id": "anthropic/claude-sonnet-4-6", "name": "Claude Sonnet 4.6 (Opper)" },
          { "id": "evroc/kimi-k2.5", "name": "Kimi K2.5 EU (Opper/Evroc)" },
          { "id": "gcp/gemini-2.5-flash-eu", "name": "Gemini 2.5 Flash EU (Opper)" }
        ]
      }
    }
  }
}
  1. Switch models at any time:
openclaw models set opper/anthropic/claude-sonnet-4-6
Session span tracing is not available via this method — that requires the native pi extension. You get full model access with a single API key.

​
pi

pi is a terminal-based coding agent. Install the @opperai/pi-provider package to get access to 260+ Opper models and automatic session span tracing: 
pi install npm:@opperai/pi-provider
export OPPER_API_KEY=your-api-key
Then use /model inside pi to switch to any Opper model. You also get 7 multimodal tools registered directly in pi: image generation, image analysis, text-to-speech, speech-to-text, web search, web fetch, and embeddings. Load only the provider or only the tools: 
{
  "packages": [
    {
      "source": "npm:@opperai/pi-provider",
      "extensions": ["extensions/provider.ts", "extensions/tools.ts"]
    }
  ]
}
Optional environment variables:
VariableDescription
OPPER_AGENT_NAMEOverride the framework name sent in headers (default: pi-code)
PI_IMAGE_SAVE_MODEDefault image save mode: tmp, project, global, or custom

​
Hermes

Hermes is an open-source terminal agent by Nous Research. Add Opper as a custom provider in ~/.hermes/config.yaml: 
# Add your Opper API key
echo 'OPPER_API_KEY=your-api-key' >> ~/.hermes/.env

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: https://api.opper.ai/v3/compat
  default: anthropic/claude-opus-4.5

# Or as a named custom provider (lets you keep other providers alongside it):
custom_providers:
  - name: opper
    base_url: https://api.opper.ai/v3/compat
    key_env: OPPER_API_KEY
With the named provider approach, switch models mid-session: 
/model custom:opper:anthropic/claude-opus-4.5
/model custom:opper:google/gemini-2.5-flash

​
Cursor

Cursor is an AI-powered code editor. Download the Opper rules file for your language and drop it in your project to give Cursor context about the Opper SDKs.
  1. Download the .mdc file for your language:
  2. Place it in your project at .cursor/rules/opper.mdc.
  3. In Cursor, make sure the rule is set to Always.

​
Cline

Cline is an AI coding agent for VS Code. Add Opper as a provider in the Cline settings panel:
  1. Select OpenAI Compatible as the API Provider.
  2. Set the Base URL to https://api.opper.ai/v2/openai.
  3. Enter your Opper API key.
  4. Set the Model ID to any model available on Opper (e.g. gcp/gemini-2.5-flash-eu).

​
Continue.dev

Continue.dev is an open-source AI code assistant for VS Code and JetBrains. Run npx @opperai/setup and select Continue, or add Opper manually to ~/.continue/config.yaml: 
models:
  - name: Gemini 2.5 Flash (EU)
    provider: openai
    model: gcp/gemini-2.5-flash-eu
    apiKey: your-api-key
    apiBase: https://api.opper.ai/v2/openai
    roles:
      - chat
      - edit

​
CLI

The Opper CLI provides a command-line interface for managing your Opper environment — calling functions, managing indexes and models, viewing traces, and configuring your setup. View on GitHub

​
Skills

Skills are markdown files that give AI code editors context about how to use Opper. They work with any editor that supports the Agent Skills standard, including Claude Code, Cursor, Cline, GitHub Copilot, OpenAI Codex, and Windsurf.

​
Installation

npx skills add opper-ai/opper-skills
Or install individual skills: 
npx skills add opper-ai/opper-skills/opper-python-sdk
npx skills add opper-ai/opper-skills/opper-node-sdk
npx skills add opper-ai/opper-skills/opper-python-agents
npx skills add opper-ai/opper-skills/opper-node-agents
npx skills add opper-ai/opper-skills/opper-api
npx skills add opper-ai/opper-skills/opper-cli

​
Available skills

SkillDescriptionLanguage
opper-python-sdkTask completion, knowledge bases, and tracingPython
opper-node-sdkTask completion, knowledge bases, and tracingTypeScript
opper-python-agentsBuild AI agents with tools, memory, and multi-agent compositionPython
opper-node-agentsBuild AI agents with tools, streaming, and multi-agent compositionTypeScript
opper-apiCall the Opper REST API directlyHTTP
opper-cliCall functions, manage indexes, track usage from the terminalBash

​
Updating skills

npx skills update