The open source gateway for ads inside AI chat and agents.

import { createClient } from "@adgate/sdk";
import { adgateMiddleware } from "@adgate/sdk/ai";
import { streamText, wrapLanguageModel } from "ai";

const adgate = createClient({
  apiKey: process.env.ADGATE_API_KEY,
  baseUrl: process.env.ADGATE_BASE_URL,
});

// Evaluates in parallel with the model call.
const result = streamText({
  model: wrapLanguageModel({
    model,
    middleware: adgateMiddleware(adgate, {
      appId: process.env.ADGATE_APP_ID,
      surface: "chat",
      getUser: () => ({ tier, region: "US", locale: "en-US" }),
      conversationId: () => conversationId,
      turnId: () => turnId,
      onDecision, // render the slot as its own message part
    }),
  }),
  prompt,
});

from adgate import AsyncAdgate, Decision

adgate = AsyncAdgate(api_key=API_KEY, base_url=BASE_URL)

# Starts before the first token; the user only waits for the model.
evaluation = asyncio.ensure_future(adgate.evaluate(request))
answer = await generate(question)

decision = await evaluation  # never raises; failures are a suppress
served = decision.decision == Decision.serve and decision.creative
if served:
    render_sponsored(decision.creative)  # below the answer, labeled
await adgate.attest(decision.audit_id, answer, rendered=served)

version: 1
serve_to_tiers: [free]
blocked_categories:
  [health, finance, politics, legal, adult, gambling, weapons, religion, self_harm]
sensitive_detection: strict
min_commercial_intent: 0.6
frequency_caps:
  per_session: 1
  per_user_per_day: 3
  min_turns_between: 4
disclosure:
  label: "Sponsored"
  position: after_answer
  style: separate_block
privacy:
  store_raw_text: false
  retain_days: 90

docker compose up -d postgres
pnpm --filter @adgate/gateway keygen >> .env
pnpm db:migrate
pnpm --filter @adgate/gateway create-app --name my-app
pnpm --filter @adgate/gateway dev      # gateway on :8787
pnpm --filter @adgate/dashboard dev    # dashboard on :3000