🦆 DuckDuckGo AI Chat Interface

---

✨ Key Features

🧠 5 Advanced AI Models

• GPT-4o mini - Versatile + WebSearch + Image Support
• Claude 3 Haiku - Excellent for creative writing
• Llama 3.3 70B - Optimized for programming
• Mistral Small - Advanced analysis and reasoning
• o4-mini - Ultra-fast for quick responses

🔧 Advanced Configuration

• Intelligent rate limiting - Automatic protection
• Configurable tools - WebSearch, news, weather, local search
• Logging system - Debugging and monitoring
• Automatic retry - Robust error recovery
• Optimized presets - Ready-to-use configurations

📱 Flexible Interfaces

• Simple messages - Intuitive API
• Real-time streaming - Progressive responses
• Multimodal support - Images with GPT-4o mini
• Persistent sessions - Conversation history
• Complete TypeScript - IntelliSense and validation

---

📦 Installation

npm install duckduckgo-chat-interface

🚀 Quick Usage

Basic Example

import { DuckDuckGoChat, Models } from 'duckduckgo-chat-interface';

const chat = new DuckDuckGoChat(Models.GPT4Mini);
await chat.initialize();

const response = await chat.sendMessage("Hello, how are you?");
console.log(response);

With WebSearch (GPT-4o mini)

import { DuckDuckGoChat, ChatConfig, Models } from 'duckduckgo-chat-interface';

const config = ChatConfig.webSearchMode();
const chat = new DuckDuckGoChat(Models.GPT4Mini, config);
await chat.initialize();

chat.enableWebSearch();
const response = await chat.sendMessage("Latest AI news?");
console.log(response);

Image Support

const images = [{
  base64: imageBase64String,
  mimeType: 'image/jpeg'
}];

const response = await chat.sendMessage("Describe this image", images);
console.log(response);

Real-time Streaming

const response = await chat.sendMessageStream(
  "Tell me a story",
  (chunk) => process.stdout.write(chunk)
);

---

📚 Documentation

• 🚀 Quick Start - Get started in 5 minutes
• 📋 API Reference - Complete API documentation
• 💡 Examples - Practical usage examples

---

📊 Models and Capabilities

Model	WebSearch	Images	Strength	Recommended Usage
GPT-4o mini	✅	✅	Versatile	General questions, search
Claude 3 Haiku	❌	❌	Creativity	Writing, explanations
Llama 3.3 70B	❌	❌	Technical	Code, programming
Mistral Small	❌	❌	Logic	Analysis, reasoning
o4-mini	❌	❌	Speed	Quick responses

---

🔧 Configuration Presets

// WebSearch mode (GPT-4o mini)
const config = ChatConfig.webSearchMode();

// News mode
const config = ChatConfig.newsMode();

// Local mode (weather + local search)
const config = ChatConfig.localMode();

// High performance mode
const config = ChatConfig.highVolumeMode();

---

📈 Examples

Explore detailed examples in the examples/ folder:

• test.js - Basic examples and configuration
• test-advanced.js - Advanced features
• test-simple.js - Simple tests and validation

---

🛡️ Compatibility

• Node.js : >= 14.0.0
• TypeScript : Full support with types
• ES Modules : Native ESM format
• Backward compatibility : 100% with 1.x versions

---

🚨 Important Notes

• WebSearch and images only with GPT-4o mini
• Rate limiting enabled by default to protect API
• initialize() required before sending messages
• Automatic retry on temporary errors

---

📞 Support and Community

• 📚 Documentation : docs/
• 💻 Examples : examples/
• 🐛 Issues : GitHub Issues
• 💬 Discussions : GitHub Discussions

---

📜 License

MIT License - see LICENSE for details.

---