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, interactive agents that integrate seamlessly with your Laravel application.

✨ Key Features

🤖 Multi-Model AI Support - Works with OpenAI, Anthropic, and Google Gemini + more, thanks to prism PHP
🎯 Sub-Agent Delegation - Agents can delegate tasks to specialized sub-agents
🛠️ 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
📊 Evaluation Framework - Automated quality testing framework for agents at scale with LLM-as-a-Judge
💬 Streaming Responses - Real-time, token-by-token streaming for responsive user experiences
📈 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,
    ];
}

// That's it! No registration needed - agents are auto-discovered

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

🛠️ 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
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 the next level with Vizra Cloud - our professional evaluation and trace analysis platform designed specifically for AI agents built with Vizra ADK.

What's Coming:

📊 Cloud Evaluation Runs - Run comprehensive evaluations at scale in the cloud
🔍 Interactive Trace Visualization - Debug and understand agent behavior with visual traces
📈 Performance Analytics - Track response times, token usage, and quality metrics
🔄 Regression Detection - Automatically catch when changes break existing functionality
🤝 Team Collaboration - Share evaluation results and insights with your team
📜 Evaluation History - Track agent performance over time and across versions
🎯 CI/CD Integration - Run evaluations automatically in your deployment pipeline
💾 Centralized Results - All evaluation data and traces in one searchable platform

Join the waitlist at vizra.ai →

🔧 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

💖 Sponsorship

Support Vizra ADK's Development

Vizra ADK is an open-source project that takes significant time and effort to maintain and improve. If you find this package valuable for your projects, please consider sponsoring its development!

🎯 Become a Sponsor on GitHub

Why Sponsor?

🚀 Accelerate Development - Your support helps us dedicate more time to new features
📚 Better Documentation - Fund comprehensive tutorials and examples
🛠️ Priority Support - Get faster responses to your issues and questions
☁️ Shape the Future - Have a direct say in our roadmap and upcoming features
💙 Support Open Source - Keep AI development tools accessible to everyone

Sponsor Benefits

$5+/month - 🎖️ Get a Sponsor badge on your GitHub profile
$25+/month - 📝 Your logo or name featured in our project README
$100+/month - 🌐 Logo placement on the Vizra website + 🚀 Access to pre-release builds
$1,000+/month - 💬 Direct support via your company chat app + All previous benefits

Every contribution, no matter the size, makes a real difference in sustaining this project. Thank you for your support! 🙏

📄 License

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

🙏 Credits

Built with ❤️ by the Vizra team and contributors.

Special thanks to:

Laravel 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 → • Join Cloud Waitlist → • Become a Sponsor →

vizra / vizra-adk

Maintainers

Details