Bun

Bun.serve routes both endpoints. socket is a fetch handler that upgrades /ws with the server Bun passes to fetch, and the bunWebSocket handlers deliver each socket's messages and close to the agent's WebsocketConnection.

InstallCopy Anchor Link

bun add @pipedog/core @pipedog/asyncio @pipedog/transport-smallwebrtc @pipedog/transport-websocket @pipedog/serializer-protobuf @pipedog/openai @pipedog/audio-silero @pipedog/audio-smart-turn

@pipedog/audio-smart-turn isn't imported anywhere: the default turn strategies load it. To run the snippet from a checkout instead, see Installation.

FilesCopy Anchor Link

The endpoints come from the shared module on the overview. voice.ts re-exports it:

export { offer, runSocketAgent, socket } from "../shared/voice.ts";

import { bunWebSocket, type UpgradingServer } from "@pipedog/transport-websocket/fetch";
import { offer, socket } from "./voice.ts";

const config = {
  fetch(request: Request, server: UpgradingServer) {
    const { pathname } = new URL(request.url);
    if (pathname === "/api/offer") return offer(request);
    // `socket` upgrades with the server Bun passes to `fetch`.
    if (pathname === "/ws") return socket(request, server);
    return new Response("not found", { status: 404 });
  },
  // Hands each upgraded socket's messages and close to its connection.
  websocket: bunWebSocket,
};

// `bun server.ts` serves the default export, on port 3000 or $PORT.
export default config;

Bun upgrades on its server, not from the Request alone, so pass server on to socket (or to upgradeWebSocket(request, { server }) from @pipedog/transport-websocket/fetch) and serve with websocket: bunWebSocket. To serve any fetch handler with WebSocket upgrades on Bun, Node or Deno without this wiring, use serveFetch() from @pipedog/transport-websocket/serve; see WebSocket.

Run itCopy Anchor Link

OPENAI_API_KEY=sk-... bun server.ts

Bun serves the default export on port 3000, or on $PORT. The offer is at POST /api/offer and the WebSocket at /ws.

DeployCopy Anchor Link

Run it as a long-lived Bun process on a host that allows UDP traffic, for the offer's media. To serve the same config on Vercel Functions, see Vercel.

AuthenticationCopy Anchor Link

Neither route has auth. Check the session in fetch before offer and socket run, as in Authentication.