vizra-adk

vizra-adk

Build, test, and deploy intelligent AI agents the Laravel way

Stars: 181

Visit
 screenshot

Vizra-ADK is a data visualization tool that allows users to create interactive and customizable visualizations for their data. With a user-friendly interface and a wide range of customization options, Vizra-ADK makes it easy for users to explore and analyze their data in a visually appealing way. Whether you're a data scientist looking to create informative charts and graphs, or a business analyst wanting to present your findings in a compelling way, Vizra-ADK has you covered. The tool supports various data formats and provides features like filtering, sorting, and grouping to help users make sense of their data quickly and efficiently.

README:

Vizra Logo

Vizra ADK - AI Agent Development Kit for Laravel

Build intelligent AI agents with Laravel's elegant syntax

Latest Version Total Downloads MIT License PHP Laravel

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

πŸ’– 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 β†’

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for vizra-adk

Similar Open Source Tools

For similar tasks

For similar jobs