DeepSeek-NET

A modern .NET wrapper for the DeepSeek AI API – integrate conversational AI into your applications with ease.

• Model Discovery: Retrieve available AI models effortlessly.
• Smart Conversations: Execute both single-turn and streaming multi-turn dialogues.
• Streaming Support: Real-time response handling for dynamic interactions.
• Modern .NET Integration: Built with .NET 8 and HttpClient best practices.

📋 Prerequisites

• DeepSeek API Key: Obtain from DeepSeek Platform
• .NET 8+: Target framework requirement

📦 Installation

dotnet add package DeepSeek-NET

🛠️ Quick Start

Initialize Client

// Simple initialization
var client = new DeepSeekClient("your_api_key_here");

// Or with custom HttpClient
var httpClient = new HttpClient();
var factoryClient = new DeepSeekClient(httpClient, "your_api_key_here");

Discover Available Models

var models = await client.ListModelsAsync();
if (models?.Data is null)
{
    Console.WriteLine($"Error: {client.ErrorMsg}");
    return;
}

foreach (var model in models.Data)
{
    Console.WriteLine($"- {model.Id}: {model.Capabilities}");
}

Basic Chat Interaction

var chatRequest = new ChatRequest
{
    Messages = new[]
    {
        Message.NewUserMessage("Explain quantum computing in 3 sentences"),
        Message.NewAssistantMessage("..."),
        Message.NewUserMessage("Now simplify it for a 5th grader")
    },
    Model = Models.DeepSeekChat
};

var response = await client.ChatAsync(chatRequest);
Console.WriteLine(response?.Choices.First().Message.Content ?? "No response");

Real-Time Streaming

var streamRequest = new ChatRequest
{
    Messages = new[] { Message.NewUserMessage("Tell a 100-word sci-fi story") },
    Model = Models.DeepSeekChat,
    Stream = true
};

var stream = await client.ChatStreamAsync(streamRequest);
if (stream is null) return;

await foreach (var chunk in stream)
{
    Console.Write(chunk.Delta?.Content);
}

🤝 Contributing

We welcome contributions! Please follow our contribution guidelines when:

• Reporting issues
• Suggesting enhancements
• Submitting pull requests

License

MIT License – See LICENSE for details.