Repolode
vizra-ai

vizra-ai/vizra-adk

A Laravel package for building, tool-equipping and deploying LLM-powered AI agents with persistent memory, tracing and a web dashboard (now retired; v0.0.48 is final).

Stars
296
Forks
37
Open issues
3
Last commit
29 days ago

What is it?

Vizra ADK is a Laravel package for building autonomous AI agents that can reason, call tools and keep persistent memory. Agents are defined as PHP classes that extend a base LLM agent class, declaring their name, instructions, model and tools, and they are auto-discovered without manual registration.

The package works with OpenAI, Anthropic and Google Gemini through the Prism PHP library, and provides Artisan commands for scaffolding agents and chatting with them from the terminal. It also covers sub-agent delegation, agent workflows (sequential, parallel, conditional and looping flows), several trigger modes including scheduled, webhook, event-driven and queue jobs, streaming responses, an LLM-as-a-Judge evaluation framework, detailed execution tracing, and a Livewire-based web dashboard.

The project is no longer maintained. Its author retired it in August 2026 with v0.0.48 as the final release, and directs users who want to build agents to the official Laravel AI SDK and users who want to evaluate agents to vizra/evals.

Key features

  • 01Defines agents as PHP classes with instructions, model and tool lists, auto-discovered by Laravel.
  • 02Supports OpenAI, Anthropic and Google Gemini models via Prism PHP.
  • 03Lets agents delegate tasks to specialized sub-agents.
  • 04Provides persistent memory across conversations and sessions.
  • 05Offers sequential, parallel, conditional and looping workflows.
  • 06Includes streaming responses, execution tracing and an LLM-as-a-Judge evaluation framework.
  • 07Ships a Livewire-based web dashboard and Artisan commands.

Use cases

  • Adding a customer support chatbot that looks up orders through custom tools inside an existing Laravel app.
  • Running scheduled or queued agent jobs that process data in the background.
  • Testing and comparing agent behavior with the built-in evaluation framework.
  • Pinning v0.0.48 for an existing Laravel project that already depends on it.

Quick start

  1. 1

    Install the package via Composer

    composer require vizra/vizra-adk
  2. 2

    Publish config and run migrations

    php artisan vizra:install
  3. 3

    Create your first agent

    php artisan vizra:make:agent CustomerSupportAgent
  4. 4

    Start chatting with the agent

    php artisan vizra:chat customer_support

Things to know

  • The project is retired as of August 2026, and v0.0.48 is the final release with no further fixes or security patches.
  • Issues and pull requests are no longer monitored.
  • Requires at least one paid LLM API key (OpenAI, Anthropic, or Google).

In collections

Topics

FAQ

What is vizra-adk?
A Laravel package for building, tool-equipping and deploying LLM-powered AI agents with persistent memory, tracing and a web dashboard (now retired; v0.0.48 is final). Vizra ADK is a Laravel package for building autonomous AI agents that can reason, call tools and keep persistent memory. Agents are defined as PHP classes that extend a base LLM agent class, declaring their name, instructions, model and tools, and they are auto-discovered without manual registration.
Is vizra-adk free to use? What license does it have?
vizra-adk is open source under the MIT license. Check the license terms before using it in commercial products.
Is vizra-adk still maintained?
Actively maintained. The last commit to vizra-adk was on Oct 9, 2026.
What can I use vizra-adk for?
Adding a customer support chatbot that looks up orders through custom tools inside an existing Laravel app. Running scheduled or queued agent jobs that process data in the background. Testing and comparing agent behavior with the built-in evaluation framework. Pinning v0.0.48 for an existing Laravel project that already depends on it.
How do I install vizra-adk?
Install the package 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 with the agent: php artisan vizra:chat customer_support
Where can I get vizra-adk?
The source code and installation instructions are on GitHub: https://github.com/vizra-ai/vizra-adk

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects