README

DeepSeek PHP Client

🚀 Community-Driven PHP SDK for DeepSeek AI API Integration

✨ Features
📦 Installation
🚀 Quick Start
🆕 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()
    ->setTemperature(1.2)
    ->query('Explain quantum computing in simple terms')
    ->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"}]}

Function Calling

Function Calling allows the model to call external tools to enhance its capabilities.[1]

You Can check the documentation for function calling in FUNCTION-CALLING.md

🛠 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.

deepseek-php / deepseek-php-client

Maintainers

Details