duck-ai-api/README.md

A wrapper around DuckDuckGo AI API to make it OpenAI compatible, making it usable for other tools.

QVD IS SOME SORT OF CHAT IDENTIFIER
EACH CHAT HISTORY HAS ITS OWN CHAIN OF QVD

STATUS -> GENERATE NEW QVD
FIRST MESSAGE (SEND QVD) -> GET BACK NEW QVD

THE NEW QVD CAN ONLY BE USED TO CONTINUE THAT MESSAGE

MESSAGES WITH DIFFERENT HISTORY WON'T WORK

# Duck AI API

## Project Overview

A wrapper around GitHub DuckDuckGo AI API to make it OpenAI compatible, making it usable for other tools.

## Using with npx

You can run the project directly using npx:

```sh
npx duck-ai-api@latest
```

With options:

```sh
npx duck-ai-api --port 8080
```

### Command Line Options

The server accepts several command line options:

| Option        | Description            | Default |
| ------------- | ---------------------- | ------- |
| --port, -p    | Port to listen on      | 4141    |
| --verbose, -v | Enable verbose logging | false   |

## Tested Tools Compatibility

| Tool                                                             | Status | Notes                                                                 |
| ---------------------------------------------------------------- | ------ | --------------------------------------------------------------------- |
| [Aider](https://github.com/Aider-AI/aider)                       | Full   | Fully compatible                                                      |
| [bolt.diy](https://github.com/stackblitz-labs/bolt.diy)          | Full   | Fully compatible; use any random API key in UI if models fail to load |
| [Page Assist](https://github.com/n4ze3m/page-assist)             | Full   | Fully compatible                                                      |
| [Kobold AI Lite](https://github.com/LostRuins/lite.koboldai.net) | Full   | Fully compatible                                                      |

**Note:** In general, any application that uses the standard OpenAI-compatible `/chat/completions` and `/models` endpoints should work with this API.