modelflow-ai / mistral
Client for mistral API.
Requires
- php: ^8.2
- modelflow-ai/api-client: ^0.2
- webmozart/assert: ^1.11
Requires (Dev)
- asapo/remove-vendor-plugin: ^0.1
- jangregor/phpstan-prophecy: ^1.0
- php-cs-fixer/shim: ^3.15
- phpspec/prophecy-phpunit: ^2.1@stable
- phpstan/extension-installer: ^1.2
- phpstan/phpstan: ^1.10, <1.10.55
- phpstan/phpstan-phpunit: ^1.3@stable
- phpunit/phpunit: ^10.3
- rector/rector: ^0.18.1
- symfony/dotenv: ^6.4 || ^7.0
This package is auto-updated.
Last update: 2024-10-25 19:14:56 UTC
README
Modelflow AI
Mistral
The Mistral package is a comprehensive API client for [Mistral AI](https://mistral.ai/), developed using PHP. It provides a robust and efficient interface for interacting with the Mistral AI model, enabling developers to seamlessly integrate AI capabilities into their PHP applications.
This package is designed with a focus on ease of use, performance, and flexibility. It allows developers to leverage the full potential of the Mistral AI model, from creating chat conversations to getting chat completions, all through a simple and intuitive API.
While the Mistral package can be used in conjunction with other packages, it is important to note that it operates independently and is not directly connected to any other package or system. This independence ensures that developers can integrate the Mistral package into their projects without any dependencies or conflicts.
Note: This is part of the
modelflow-ai
project create issues in the main repository.
Note: This project is heavily under development and any feedback is greatly appreciated.
Installation
To install the Mistral package, you need to have PHP 8.2 or higher and Composer installed on your machine. Then, you can add the package to your project by running the following command:
composer require modelflow-ai/mistral
Examples
Here are some examples of how you can use the Mistral in your PHP applications. You can find more detailed examples in the examples directory.
Usage
Creating a Client
First, you need to create a client. The client is the main entry point to interact with the Mistral AI model. You can
create a client using the Mistral
class:
use ModelflowAi\Mistral\Mistral; $client = Mistral::client('your-api-key');
Using the Chat Resource
The Chat resource allows you to create chat conversations and get chat completions.
$chat = $client->chat(); // Create a chat conversation $parameters = [ 'model' => 'mistral-medium', 'messages' => [ [ 'role' => 'system', 'content' => 'You are a helpful assistant.' ], [ 'role' => 'user', 'content' => 'Who won the world series in 2020?' ] ] ]; $response = $chat->create($parameters); // The response is an instance of CreateResponse echo $response->id;
Using the Embeddings Resource
The Embeddings resource allows you to generate and manipulate embeddings for your data.
$embeddings = $client->embeddings(); // Generate embeddings for your data $parameters = [ 'model' => 'mistral-medium', 'texts' => ['text1', 'text2'] ]; $response = $embeddings->create($parameters); // The response is an instance of CreateResponse echo $response->id;
API Documentation
For more detailed information about the Mistral API, please refer to the official API documentation.
Open Points
Model API
The Model API is another area that we are actively working on. Once completed, this will provide users with the ability to manage and interact with their AI models directly from the Mistral package.
Testing
To run the tests, use PHPUnit:
composer test
Contributing
Contributions are welcome. Please open an issue or submit a pull request in the main repository at https://github.com/modelflow-ai/.github.
License
This project is licensed under the MIT License. For the full copyright and license information, please view the LICENSE file that was distributed with this source code.