DeepSeek PHP Client

🚀 Community-Driven PHP SDK for DeepSeek AI API Integration

AR | CN

Table of Contents

• ✨ Features
• 📦 Installation
• 🚀 Quick Start
  • Basic Usage
  • Advanced Configuration
  • Use with Symfony HttpClient
  • Get Models List
  • Framework Integration
• 🆕 Migration Guide
• 📝 Changelog
• 🧪 Testing
• 🔒 Security
• 🤝 Contributors
• 📄 License

---

✨ Features

• Seamless API Integration: PHP-first interface for DeepSeek's AI capabilities.
• Fluent Builder Pattern: Chainable methods for intuitive request building.
• Enterprise Ready: PSR-18 compliant HTTP client integration.
• Model Flexibility: Support for multiple DeepSeek models (Coder, Chat, etc.).
• Streaming Ready: Built-in support for real-time response handling.
• Many Http Clients: easy to use Guzzle http client (default) , or symfony http client.
• Framework Friendly: Laravel & Symfony packages available.

---

📦 Installation

Require the package via Composer:

composer require deepseek-php/deepseek-php-client

Requirements:

• PHP 8.1+

---

🚀 Quick Start

Basic Usage

Get started with just two lines of code:

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->query('Explain quantum computing in simple terms')
    ->run();

echo $response;

📌 Defaults used:

• Model: deepseek-chat
• Temperature: 0.8

Advanced Configuration

use DeepSeek\DeepSeekClient;
use DeepSeek\Enums\Models;

$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'guzzle');

$response = $client
    ->withModel(Models::CODER->value)
    ->withStream()
    ->withTemperature(1.2)
    ->run();

echo 'API Response:'.$response;

Use with Symfony HttpClient

the package already built with symfony Http client, if you need to use package with symfony Http Client , it is easy to achieve that, just pass clientType:'symfony' with build function.

ex with symfony:

//  with defaults baseUrl and timeout
$client = DeepSeekClient::build('your-api-key', clientType:'symfony')
// with customization
$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'symfony');

$client->query('Explain quantum computing in simple terms')
       ->run();

Get Models List

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->getModelsList()
    ->run();

echo $response; // {"object":"list","data":[{"id":"deepseek-chat","object":"model","owned_by":"deepseek"},{"id":"deepseek-reasoner","object":"model","owned_by":"deepseek"}]}

🛠 Framework Integration

Laravel Deepseek Package

---

🚧 Migration Guide

Upgrading from v1.x? Check our comprehensive Migration Guide for breaking changes and upgrade instructions.

---

📝 Changelog

Detailed release notes available in CHANGELOG.md

---

🧪 Testing

./vendor/bin/pest

Test coverage coming in v2.1.

---

🐘✨ DeepSeek PHP Community ✨🐘

Click the button bellow or join here to be part of our growing community!

Channel Structure 🏗️

• 🗨️ General - Daily chatter
• 💡 Ideas & Suggestions - Shape the community's future
• 📢 Announcements & News - Official updates & news
• 🚀 Releases & Updates - Version tracking & migration support
• 🐞 Issues & Bug Reports - Collective problem-solving
• 🤝 Pull Requests - Code collaboration & reviews

---

🔒 Security

Report Vulnerabilities: to omaralwi2010@gmail.com

---

🤝 Contributors

A huge thank you to these amazing people who have contributed to this project! 🎉💖

Omar AlAlwi 🏆 Creator

Ayman Alhattami ⭐ Contributor

Mohammad Asaad ⭐ Contributor

Opada Alzaiede ⭐ Contributor

Hisham Bin Ateya ⭐ Contributor

Vinchan ⭐ Contributor

Want to contribute? Check out the contributing guidelines and submit a pull request! 🚀

---

📄 License

This package is open-source software licensed under the MIT License.