deepseek/deepseek-php-client

Community-Driven PHP SDK for DeepSeek AI API Integration.

v2.0.3 2025-03-03 12:33 UTC

Requires

• php: ^8.1.0
• nyholm/psr7: ^1.8
• php-http/discovery: ^1.20.0
• php-http/multipart-stream-builder: ^1.4.2
• psr/http-client: ^1.0.3
• psr/http-client-implementation: 1.0
• psr/http-factory-implementation: *
• psr/http-message: ^1.1.0|^2.0.0
• symfony/http-client: ^6.4

Requires (Dev)

• guzzlehttp/guzzle: ^7.9.2
• guzzlehttp/psr7: ^2.7.0
• laravel/pint: ^1.18.1
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^7.11.0|^8.5.0
• pestphp/pest: ^2.36
• pestphp/pest-plugin-arch: ^2.7
• pestphp/pest-plugin-type-coverage: ^2.8.7
• phpstan/phpstan: ^1.12.7
• roave/security-advisories: dev-latest
• symfony/var-dumper: ^6.4.11|^7.1.5

MIT

• jundayw

• symfony
• php
• api
• client
• sdk
• nlp
• ai
• php-sdk
• rest-client
• api-wrapper
• machine-learning
• natural-language-processing
• developer-tools
• php-api-client
• ai-sdk
• api-integration
• openai
• text-generation
• llm
• generative-ai
• deepseek
• deepseek-api
• ai-api
• deepseek-ai
• ai-client-library
• php-ai-integration
• openai-alternative
• symfony-deepseek
• deepseek-symfony
• symfony-http-client
• symfony-client

README

Table of Contents

• Features
• Installation
• Quick Start
  • Basic Usage
  • Advanced Configuration
  • Use with Symfony HttpClient
  • Get Models List
• Testing
• 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

You can install the package via Composer:

composer require deepseek/deepseek-php-client

Requirements:

Requires 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"}]}

Testing

./vendor/bin/pest

Test coverage coming in v2.1.

License

Nacosvel Contracts is made available under the MIT License (MIT). Please see License File for more information.