first initlize

Author: omaralalwi

CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to `sdk` will be documented in this file
+
+## 1.0.0 - 201X-XX-XX
+
+- initial release

CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing
+
+Contributions are **welcome** and will be fully **credited**.
+
+Please read and understand the contribution guide before creating an issue or pull request.
+
+## Etiquette
+
+This project is open source, and as such, the maintainers give their free time to build and maintain the source code
+held within. They make the code freely available in the hope that it will be of use to other developers. It would be
+extremely unfair for them to suffer abuse or anger for their hard work.
+
+Please be considerate towards maintainers when raising issues or presenting pull requests. Let's show the
+world that developers are civilized and selfless people.
+
+It's the duty of the maintainer to ensure that all submissions to the project are of sufficient
+quality to benefit the project. Many developers have different skillsets, strengths, and weaknesses. Respect the maintainer's decision, and do not be upset or abusive if your submission is not used.
+
+## Viability
+
+When requesting or submitting new features, first consider whether it might be useful to others. Open
+source projects are used by many developers, who may have entirely different needs to your own. Think about
+whether or not your feature is likely to be used by other users of the project.
+
+## Procedure
+
+Before filing an issue:
+
+- Attempt to replicate the problem, to ensure that it wasn't a coincidental incident.
+- Check to make sure your feature suggestion isn't already present within the project.
+- Check the pull requests tab to ensure that the bug doesn't have a fix in progress.
+- Check the pull requests tab to ensure that the feature isn't already in progress.
+
+Before submitting a pull request:
+
+- Check the codebase to ensure that your feature doesn't already exist.
+- Check the pull requests to ensure that another person hasn't already submitted the feature or fix.
+
+## Requirements
+
+If the project maintainer has any additional requirements, you will find them listed here.
+
+- **[PSR-2 Coding Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** - The easiest way to apply the conventions is to install [PHP Code Sniffer](https://pear.php.net/package/PHP_CodeSniffer).
+
+- **Add tests!** - Your patch won't be accepted if it doesn't have tests.
+
+- **Document any change in behaviour** - Make sure the `README.md` and any other relevant documentation are kept up-to-date.
+
+- **Consider our release cycle** - We try to follow [SemVer v2.0.0](https://semver.org/). Randomly breaking public APIs is not an option.
+
+- **One pull request per feature** - If you want to do more than one thing, send multiple pull requests.
+
+- **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](https://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.
+
+**Happy coding**!

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) qwen-php
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,125 @@
+<p align="center">
+  <a href="https://qwen-php/qwen-php-client" target="_blank">
+    <img src="https://raw.githubusercontent.com/qwen-php/qwen-php-client/master/public/images/qwen_screenshot.png" alt="Gpdf">
+  </a>
+</p>
+
+## 🚧 This Project is Under Development!
+
+V1 will Released in few Days .
+
+# qwen PHP Client
+
+## Table of Contents
+- [Overview](#Overview)
+    - [Features](#key-Features)
+- [Installation](#installation)
+- [Quick Start Guide](#quick-start-guide)
+    - [Basic Usage](#basic-usage)
+    - [Advanced Usage](#advanced-usage)
+    - [Use With Frameworks](#use-with-frameworks)
+- [Testing](#testing)
+- [Contributors](#contributors-)
+- [License](#license)
+
+---
+## Overview
+**qwen PHP Client** is a robust and community-driven PHP client library for seamless integration with the [Qwen](https://qwenlm.ai/) API.
+### Key Features
+- **Easy Integration:** Simplifies interaction with the qwen API using a PHP client.
+- **Method Chaining:** Supports fluent method chaining for building requests.
+- **Customizable:** Allows setting different models, query roles, and streaming options.
+- **PSR-18 Compliance:** Utilizes PSR-18 HTTP client for making API requests.
+
+---
+
+## Installation
+
+You can install the package via Composer:
+
+```bash
+composer require qwen-php/qwen-php-client
+```
+
+**Ensure your project meets the following requirements:**
+- PHP 8.1 or later
+
+---
+
+## Quick Start Guide
+
+### Basic Usage
+
+```php
+use Qwen\QwenClient;
+
+$apiKey = 'your-api-key';
+
+$response = QwenClient::build($apiKey)
+    ->query('Hello qwen, how are you today?')
+    ->run();
+
+echo 'API Response:'.$response;
+```
+
+**Note**: in easy mode it will take defaults for all configs [Check Default Values](https://github.com/qwen-php/qwen-php-client/blob/master/src/Enums/Configs/DefaultConfigs.php)
+
+### Advanced Usage
+
+```php
+use Qwen\QwenClient;
+use Qwen\Enums\Queries\QueryRoles;
+use Qwen\Enums\Models;
+
+$apiKey = 'your-api-key';
+
+$response = QwenClient::build($apiKey, 'https://dashscope-intl.aliyuncs.com', 500)
+    ->query('System setup query', 'system')
+    ->query('User input message', 'user')
+    ->withModel(Models::CODER->value)
+    ->run();
+
+echo 'API Response:'.$response;
+```
+
+## Use With Frameworks
+
+Coming soon
+
+---
+
+## Testing
+
+tests will come soon .
+
+## Changelog
+
+See [CHANGELOG](CHANGELOG.md) for recent changes.
+
+## Contributors ✨
+
+Thanks to these wonderful people for contributing to this project! 💖
+
+<table>
+  <tr>
+    <td align="center">
+      <a href="https://github.com/omaralalwi">
+        <img src="https://avatars.githubusercontent.com/u/25439498?v=4" width="50px;" alt="Omar AlAlwi"/>
+        <br />
+        <sub><b>Omar AlAlwi</b></sub>
+      </a>
+      <br />
+      🏆 Creator
+    </td>
+ </tr>
+</table>
+
+Want to contribute? Check out the [contributing guidelines](./CONTRIBUTING.md) and submit a pull request! 🚀
+
+## Security
+
+If you discover any security-related issues, please email creator : `[email protected]`.
+
+## License
+
+The MIT License (MIT). See [LICENSE](LICENSE.md) for more information.

composer.json

@@ -0,0 +1,118 @@
+{
+    "name": "qwen-php/qwen-php-client",
+    "description": "robust and community-driven PHP SDK library for seamless integration with the qwen AI API, offering efficient access to advanced AI and data processing capabilities",
+    "homepage": "https://github.com/qwen-php/qwen-php-client",
+    "license": "MIT",
+    "type": "library",
+    "keywords": [
+        "qwen",
+        "qwen-php-sdk",
+        "qwen-sdk",
+        "qwen-api",
+        "php-qwen",
+        "alibaba-ai",
+        "alibaba",
+        "qwen-coder",
+        "qwen-integration",
+        "openai",
+        "deepseek",
+        "deepseek-php",
+        "sdk",
+        "codex",
+        "GPT-3",
+        "DALL-E",
+        "api",
+        "client",
+        "php-sdk",
+        "php-ai",
+        "ai-for-php",
+        "ai-sdk",
+        "ai-api",
+        "natural",
+        "language",
+        "processing",
+        "qwen-php-library",
+        "qwen-client",
+        "natural-language-processing",
+        "ai-integration",
+        "machine-learning",
+        "php-machine-learning",
+        "php-iot",
+        "nlp",
+        "data-processing",
+        "deep-learning",
+        "qwen-library",
+        "php-library",
+        "api-integration",
+        "php-api-client",
+        "qwen-ai",
+        "php-openai-alternative",
+        "ai-client-library"
+    ],
+    "authors": [
+        {
+            "name": "qwen-php",
+            "email": "[email protected]",
+            "role": "owner"
+        },
+        {
+            "name": "Omar Alalwi",
+            "email": "[email protected]",
+            "role": "creator"
+        }
+    ],
+    "version": "1.0.0",
+    "require": {
+        "php": "^8.1.0",
+        "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.1",
+        "psr/http-factory-implementation": "*",
+        "psr/http-message": "^1.1.0|^2.0.0"
+    },
+    "require-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.0|^3.5.0",
+        "pestphp/pest-plugin-arch": "^2.7|^3.0",
+        "pestphp/pest-plugin-type-coverage": "^2.8.7|^3.1.0",
+        "phpstan/phpstan": "^1.12.7",
+        "roave/security-advisories": "dev-latest",
+        "symfony/var-dumper": "^6.4.11|^7.1.5"
+    },
+    "autoload": {
+        "psr-4": {
+            "Qwen\\": "src"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Qwen\\Tests\\": "tests"
+        }
+    },
+    "scripts": {
+        "lint": "pint -v",
+        "test:lint": "pint --test -v",
+        "test:types": "phpstan analyse --ansi",
+        "test:type-coverage": "pest --type-coverage --min=100",
+        "test:unit": "pest --colors=always",
+        "test": [
+            "@test:lint",
+            "@test:types",
+            "@test:type-coverage",
+            "@test:unit"
+        ]
+    },
+    "config": {
+        "sort-packages": true,
+        "preferred-install": "dist",
+        "allow-plugins": {
+            "pestphp/pest-plugin": true,
+            "php-http/discovery": true
+        }
+    }
+}

public/qwen_screenshot.png.png

@@ -0,0 +1,14 @@
+<?php
+
+namespace Qwen\Contracts;
+
+use Qwen\DeepseekClient;
+
+interface DeepseekClientContract
+{
+    public static function build(string $apiKey): self;
+    public function run(): string;
+    public function query(string $content, ?string $role = "user"): self;
+    public function withModel(?string $model = null): self;
+    public function withStream(bool $stream = true): self;
+}

src/Contracts/DeepseekClientContract.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Qwen\Contracts\Factories;
+
+use Qwen\Factories\ApiFactory;
+use GuzzleHttp\Client;
+
+interface ApiFactoryContract
+{
+    /**
+     * Create a new instance of the factory.
+     *
+     * @return ApiFactory
+     */
+    public static function build(): ApiFactory;
+
+    /**
+     * Set the base URL for the API.
+     *
+     * @param string|null $baseUrl The base URL to set (optional).
+     * @return ApiFactory
+     */
+    public function setBaseUri(?string $baseUrl = null): ApiFactory;
+
+    /**
+     * Set the API key for authentication.
+     *
+     * @param string $apiKey The API key to set.
+     * @return ApiFactory
+     */
+    public function setKey(string $apiKey): ApiFactory;
+
+    /**
+     * Set the timeout for the API request.
+     *
+     * @param int|null $timeout The timeout value in seconds (optional).
+     * @return ApiFactory
+     */
+    public function setTimeout(?int $timeout = null): ApiFactory;
+
+    /**
+     * Build and return the Guzzle Client instance.
+     *
+     * @return Client
+     */
+    public function run(): Client;
+}