An OpenAI-compatible API for Duck.ai — driven by a real browser.

What it is

Duck.ai publishes no public API. This project drives the ordinary web interface in a real browser and repackages the stream as an OpenAI-compatible surface.

Running it locally

Python 3.11 or newer (the bridge uses asyncio.timeout).

1. Install dependencies

   Create a virtual environment, then install the Python packages and the Chromium build Playwright needs.

   terminalcopy

   # 1. install packages
   pip install -r requirements.txt
   
   # 2. download the Chromium binary
   playwright install chromium

2. Start the server

   Defaults to http://localhost:3006. The web GUI is at /, the schema at /docs.

   terminalcopy

   python server.py

3. Point any OpenAI client at it

   Use http://localhost:3006/v1 as the base URL. If API_KEY is unset, any key value is accepted.

   pythoncopy

   from openai import OpenAI
   
   client = OpenAI(base_url="http://localhost:3006/v1", api_key="duckai")
   
   stream = client.chat.completions.create(
       model="gpt-6-luna",
       messages=[{"role": "user", "content": "Explain quantum computing in one sentence."}],
       stream=True,
   )
   for chunk in stream:
       print(chunk.choices[0].delta.content or "", end="", flush=True)

API endpoints

All endpoints live under the same host and port as the GUI.

Streaming a completion

curl -N -X POST http://localhost:3006/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-6-luna",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

Tip: pass "stream": false to receive a single JSON chat.completion object instead of SSE chunks. Model names are validated — an unknown model returns HTTP 400.

Available models

Aliases on the right are accepted too and resolved to the canonical model.

Environment variables

Everything is optional — sensible defaults ship in the Docker image.

Docker

# build & run with compose
docker compose up --build

# …or plain docker
docker build -t duckai-api .
docker run -p 3006:3006 -e API_KEY="your-secret" duckai-api

The image is based on python:3.11-slim and ships Chromium plus its system libraries, so no host browser is required.

Hardening notes

This project was audited adversarially; the findings below have been addressed in the current revision.

Still your responsibility: when API_KEY is unset the API is open, and /health, /docs and the GUI remain unauthenticated. Bind to a trusted network, or set a key and put it behind a reverse proxy.