README

Vizra ADK - AI Agent Development Kit for Laravel

Build intelligent AI agents with Laravel's elegant syntax

Vizra ADK is a comprehensive Laravel package for building autonomous AI agents that can reason, use tools, and maintain persistent memory. Create intelligent, inertactive agents that integrate seamlessly with your Laravel application.

✨ Key Features

🤖 Multi-Model AI Support - Works with OpenAI, Anthropic Claude, and Google Gemini, thanks to prism PHP
🛠️ Extensible Tool System - Give agents abilities to interact with databases, APIs, and external services
🧠 Persistent Memory - Agents remember conversations and learn from interactions across sessions
🔄 Agent Workflows - Build complex processes with sequential, parallel, conditional flows and loops
⚡ Execution Modes - Multiple trigger modes: conversational, scheduled, webhook, event-driven, and queue jobs
📊 LLM-as-a-Judge Evaluation - Automated quality testing framework for agents at scale
💬 Streaming Responses - Real-time, token-by-token streaming for responsive user experiences
🎯 Sub-Agent Delegation - Agents can delegate tasks to specialized sub-agents
📈 Comprehensive Tracing - Debug and monitor agent execution with detailed traces
🎨 Web Dashboard - Beautiful Livewire-powered interface for testing and monitoring
🔧 Laravel Native - Built with Laravel patterns: Artisan commands, Eloquent models, service providers

🚀 Quick Start

# Install via Composer
composer require vizra/vizra-adk

# Publish config and run migrations
php artisan vizra:install

# Create your first agent
php artisan vizra:make:agent CustomerSupportAgent

# Start chatting!
php artisan vizra:chat customer_support

💻 Basic Usage

<?php

use Vizra\VizraADK\Agents\BaseLlmAgent;
use Vizra\VizraADK\Facades\Agent;

// Define your agent
class CustomerSupportAgent extends BaseLlmAgent
{
    protected string $name = 'customer_support';
    protected string $description = 'Helps customers with inquiries';
    protected string $instructions = 'You are a helpful customer support assistant.';
    protected string $model = 'gpt-4o';

    protected array $tools = [
        OrderLookupTool::class,
        RefundProcessorTool::class,
    ];
}

// Register in AppServiceProvider
public function boot(): void
{
    Agent::build(CustomerSupportAgent::class)->register();
}

// Use your agent
$response = CustomerSupportAgent::ask('I need help with my order')
    ->forUser($user)
    ->execute();

🛠️ Creating Tools

Tools extend your agent's capabilities:

use Vizra\VizraADK\Contracts\ToolInterface;
use Vizra\VizraADK\System\AgentContext;

class OrderLookupTool implements ToolInterface
{
    public function definition(): array
    {
        return [
            'name' => 'order_lookup',
            'description' => 'Look up order information',
            'parameters' => [
                'type' => 'object',
                'properties' => [
                    'order_id' => [
                        'type' => 'string',
                        'description' => 'The order ID',
                    ],
                ],
                'required' => ['order_id'],
            ],
        ];
    }

    public function execute(array $arguments, AgentContext $context): string
    {
        $order = Order::find($arguments['order_id']);

        return json_encode([
            'status' => 'success',
            'order' => $order->toArray(),
        ]);
    }
}

📚 Full Documentation

For comprehensive documentation, tutorials, and API reference, visit:

📖 https://vizra.ai/docs

🌟 Why Vizra ADK?

Laravel First - Built specifically for Laravel developers with familiar patterns
Production Ready - Battle-tested with comprehensive error handling and logging
No Vendor Lock-in - Switch between AI providers without changing your code
Developer Experience - Elegant API, helpful error messages, and extensive documentation
Community Driven - Open source with active development and support

🚀 Vizra Cloud Platform (Coming Soon!)

Take your agents to production with Vizra Cloud - our managed hosting platform designed specifically for AI agents built with Vizra ADK.

What's Coming:

🌐 One-Click Deployment - Deploy agents directly from GitHub
⚡ Auto-Scaling - Handle any load with automatic scaling
🔒 Enterprise Security - SOC2 compliant infrastructure
📊 Analytics Dashboard - Monitor usage, costs, and performance
🤝 Team Collaboration - Manage agents and deployments with your team
🌍 Global Edge Network - Low latency worldwide
💾 Managed Vector Database - Built-in memory storage
🔧 Zero Configuration - We handle the infrastructure

Join the waitlist at vizra.ai →

🤝 Sponsorship

Vizra ADK is open source and free to use. If you find it valuable, please consider sponsoring the project to help us maintain and improve it.

💖 Become a Sponsor

Your sponsorship helps us:

🚀 Develop new features faster
🐛 Provide better support and bug fixes
📚 Improve documentation and examples
🌟 Keep the project sustainable

Sponsor Vizra ADK on GitHub →

Every contribution, no matter the size, makes a difference! Sponsors get:

🏆 Recognition in our README and website
🎯 Priority support for issues
🗳️ Influence on the roadmap

🔧 Requirements

PHP 8.2+
Laravel 11.0+
MySQL/PostgreSQL
At least one LLM API key (OpenAI, Anthropic, or Google)

🤝 Community & Support

GitHub Discussions - Ask questions, share ideas
GitHub Issues - Report bugs, request features
Twitter/X - Latest updates and tips

📄 License

Vizra ADK is open-sourced software licensed under the MIT license.

🙏 Credits

Built with ❤️ by the Vizra team and contributors.

Special thanks to:

The Laravel team for creating an amazing framework
Prism PHP for the powerful LLM integration library
Livewire for making our web dashboard reactive and beautiful
League CSV for handling CSV in our evaluation framework
The AI/ML community for pushing boundaries

Ready to build intelligent AI agents?
Get Started → • Sponsor → • Join Cloud Waitlist →

vizra / vizra-adk

Maintainers

Details