https://github.com/ramona-flower/duckduckai
Python API Wrapper to interact with DuckDuckAI
https://github.com/ramona-flower/duckduckai
ai ai-wrapper api claude claude-ai duckduckgo free gpt gpt-4o llama meta-llama mistral mistral-7b package pypi python
Last synced: 2 months ago
JSON representation
Python API Wrapper to interact with DuckDuckAI
- Host: GitHub
- URL: https://github.com/ramona-flower/duckduckai
- Owner: Ramona-Flower
- License: apache-2.0
- Created: 2025-01-24T09:20:25.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-10T20:12:08.000Z (2 months ago)
- Last Synced: 2025-02-10T21:24:06.745Z (2 months ago)
- Topics: ai, ai-wrapper, api, claude, claude-ai, duckduckgo, free, gpt, gpt-4o, llama, meta-llama, mistral, mistral-7b, package, pypi, python
- Language: Python
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DuckDuckAI
DuckDuckAI is a Python package for interacting with DuckDuckGo's chat API. It allows you to fetch responses from DuckDuckGo's AI models and print them in a streamed format or as a complete response.
## Installation
To install the DuckDuckAI package, you can use pip:
```bash
pip install DuckDuckAI
```
## Usage
You can interact with DuckDuckAI by calling the `ask` function. It supports both streaming responses or returning the entire message at once.
### Example
```py
from duckduckai import ask
# Fetch response in streamed format (printing character by character)
ask("Tell me a joke", stream=True)
# Fetch response as a complete message
response = ask("Tell me a joke", stream=False)
print(response)
```
### Parameters Table
| Parameter | Type | Description | Default |
|-----------|-------|---------------------------------------------------------------------|---------------|
| query | str | The search query string. | Required |
| stream | bool | Whether to stream results or fetch them all at once. | True |
| model | str | The model to use for the response (e.g., gpt-4o-mini). | gpt-4o-mini |
### List of Models
Here is the list of available models:
1. ```mistralai/Mixtral-8x7B-Instruct-v0.1``` A model trained by Mistral for instruction-based tasks with 8x7B parameters.
2. ```meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo``` Meta's large-scale model with 70 billion parameters designed for fast and accurate responses.
3. ```claude-3-haiku-20240307``` A model optimized for generating short, poetic, and haiku-style text, using Claude 3 architecture.
4. ```gpt-4o-mini``` A smaller variant of GPT-4 designed for quick, concise responses with less computation.
5. ```o3-mini``` A compact and efficient AI model optimized for lightweight performance.
# License
This project is licensed under the Apache-2.0 license - see the LICENSE file for details.