Seamlessly integrate Grok AI into Laravel applications with an elegant, developer-friendly package. Leverage powerful AI models for chat, automation, and NLP while maintaining Laravel's expressive simplicity.

#🧠 Grok AI Laravel

Seamlessly integrate Grok AI into Laravel applications with an elegant, developer-friendly package.
Leverage powerful AI models for chat, automation, and NLP, while maintaining Laravel's expressive simplicity.

#📖 Table of Contents

• ✨ Features
• 📦 Installation
• 🚀 Quick Start
  • Basic Usage
  • Advanced Configuration
• 📌 Available Grok AI Models
• ⚡ Streaming Responses
• 🧪 Testing
• 🔒 Security
• 🤝 Contributing
• 📄 License

#✨ Features

✅ Seamless Laravel Integration – Works effortlessly with Laravel 10+
✅ Simple API Client – Access Grok AI models with a fluent, clean syntax
✅ Supports All Grok AI Models – Choose from multiple LLM & vision models
✅ Streaming Capable – Enable real-time AI responses for interactive experiences
✅ Configurable Defaults – Set your preferred model, temperature, and more

#📦 Installation

Install via Composer:

composer require grok-php/laravel

After installation, run the setup command:

php artisan grok:install

This command will:

• Publish the configuration file (config/grok.php).
• Add necessary environment variables to .env and .env.example.

Add your API key in .env:

GROK_API_KEY=your-api-key

#🚀 Quick Start

#Basic Usage

use GrokPHP\Laravel\Facades\GrokAI;
use GrokPHP\Client\Config\ChatOptions;
use GrokPHP\Client\Enums\Model;
 
$response = GrokAI::chat(
    [['role' => 'user', 'content' => 'Hello Grok!']],
    new ChatOptions(model: Model::GROK_2)
);
 
echo $response['choices'][0]['message']['content'];

#📌 Defaults Used:

Model: grok-2 Temperature: 0.7 Streaming: false

#Advanced Configuration

Modify your config/grok.php file:

return [
    'api_key' => env('GROK_API_KEY'),
    'base_uri' => env('GROK_BASE_URI', 'https://api.grok.com/v1'),
    'default_model' => env('GROK_DEFAULT_MODEL', 'grok-2'),
    'default_temperature' => env('GROK_DEFAULT_TEMPERATURE', 0.7),
    'enable_streaming' => env('GROK_ENABLE_STREAMING', false),
    'timeout' => env('GROK_API_TIMEOUT', 30),
];

📌 You can override any setting dynamically:

$response = GrokAI::chat(
    [['role' => 'user', 'content' => 'Explain black holes']],
    new ChatOptions(model: Model::GROK_2_LATEST, temperature: 1.2, stream: true)
);

#📌 Available Grok AI Models

Grok AI offers multiple models, each optimized for different use cases. These models are available in the Model enum inside our package: 📄 src/Enums/Model.php

#📌 Default model used: Model::GROK_2

#⚡ Streaming Responses

Enable real-time AI responses by setting stream: true:

$response = GrokAI::chat(
    [['role' => 'user', 'content' => 'Tell me a story']],
    new ChatOptions(model: Model::GROK_2, stream: true)
);

#Streaming is useful for chatbots, assistants, and real-time applications.

#🧪 Testing

Run tests using Pest PHP:

composer test
or
vendor/bin/phpunit

#🔒 Security

If you discover a security vulnerability, please report it via email: 📩 thefeqy@gmail.com

#🤝 Contributing

Want to improve this package? Check out CONTRIBUTE.md for contribution guidelines.

#📄 License

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