php-gemini/generative-ai

Laravel-friendly PHP Package for Google Gemini Generative AI (including image & text)

v1.0.0 2025-06-29 15:08 UTC

Requires

• php: >=8.0
• google/auth: ^1.47
• guzzlehttp/guzzle: ^7.0
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• illuminate/config: ^12.19
• illuminate/contracts: ^12.19
• illuminate/support: ^12.19

MIT

• Zero-Asif

• php
• google
• sdk
• laravel
• ai
• vision
• Gemini
• generative

README

A Laravel-friendly, lightweight PHP SDK to interact with Google Gemini Generative AI. Supports text generation, image input (vision), and is fully customizable for any PHP project.

✨ Features

• ✅ Gemini text generation (prompt → response)
• 🖼️ Image input support (base64 vision models)
• ⚙️ Configurable model & API key via .env
• 🎯 Laravel-ready (service provider + facade)
• 🔒 OAuth2 support planned
• 📦 Composer installable
• 📘 Full documentation included

🧪 Installation

Install via Composer:

composer require php-gemini/generative-ai

⚙️ Configuration

For Laravel users, publish the configuration file:

php artisan vendor:publish --provider="PhpGemini\GenerativeAI\Providers\GeminiServiceProvider"

Then update your .env file:

GEMINI_API_KEY=your_actual_api_key
GEMINI_MODEL=gemini-1.5-flash

You can also update config/gemini.php as needed.

🚀 Usage

✅ In Laravel

use Gemini;

echo Gemini::generate("What's the future of AI?");

✅ In Plain PHP

use PhpGemini\GenerativeAI\GeminiClient;

require 'vendor/autoload.php';

$gemini = new GeminiClient('your_api_key', 'gemini-1.5-flash');
echo $gemini->generateContent("Tell me something interesting.");

🖼️ Image Input (Vision Model)

$response = $gemini->generateContentWithImage('path/to/image.jpg', 'What’s in this image?');

⚠️ Note: Only works with models that support image input, like gemini-1.5-flash or gemini-pro-vision.

🛠️ Roadmap

• Text generation
• Laravel integration
• Image input (vision support)
• Streaming response support
• OAuth2 integration
• Unit testing & mocking
• Online documentation site (mkdocs)

📘 Documentation

Full documentation is available inside: docs/index.md

🤝 Contributing

Pull requests, issues, and feature suggestions are welcome!

git clone [https://github.com/php-gemini/generative-ai.git](https://github.com/php-gemini/generative-ai.git)
cd generative-ai
composer install

📄 License

This project is open-sourced under the MIT license.

🔗 Useful Links

• Packagist: php-gemini/generative-ai
• Gemini API Docs: https://ai.google.dev
• Documentation: docs/index.md

🙋 Author

Zero-Asif (Asifuzzaman Asif)

• 📧 Email: [e-mail]
• 🔗 GitHub: github.com/Zero-Asif

✨ If this project helped you, please ⭐ the repo!