LarAgent - Power of AI Agents in your Laravel project

[MaestroError]

LarAgent brings the power of AI agents to your Laravel projects with an elegant syntax. Create, extend, and manage AI agents with ease while maintaining Laravel's fluent API design patterns.

What if you can create AI agents just like you create any other Eloquent model?

Why not?! 👇

php artisan make:agent YourAgentName

And it looks familiar, isn't it?

namespace App\AiAgents;

use LarAgent\Agent;

class YourAgentName extends Agent
{
    protected $model = 'gpt-4';

    protected $history = 'in_memory';

    protected $provider = 'default';

    protected $tools = [];

    public function instructions()
    {
        return "Define your agent's instructions here.";
    }

    public function prompt($message)
    {
        return $message;
    }
}

And you can tweak the configs, like history

// ...
protected $history = \LarAgent\History\CacheChatHistory::class;
// ...

Or add temperature:

// ...
protected $temperature = 0.5;
// ...

Even disable parallel tool calls:

// ...
protected $parallelToolCalls = false;
// ...

Oh, and add a new tool as well:

// ...
#[Tool('Get the current weather in a given location')]
public function exampleWeatherTool($location, $unit = 'celsius')
{
    return 'The weather in '.$location.' is '.'20'.' degrees '.$unit;
}
// ...

And run it, per user:

Use App\AiAgents\YourAgentName;
// ...
YourAgentName::forUser(auth()->user())->respond($message);

Or use a custom name for the chat history:

Use App\AiAgents\YourAgentName;
// ...
YourAgentName::for("custom_history_name")->respond($message);

Let's find out more with documentation below 👍

Features

• Eloquent-like syntax for creating and managing AI agents
• Laravel-style artisan commands
• Flexible agent configuration (model, temperature, context window, etc.)
• Structured output handling
• Image input support
• Easily extendable, including chat histories and LLM drivers
• Multiple built-in chat history storage options (in-memory, cache, json, etc.)
  • Per-user chat history management
  • Custom chat history naming support
• Custom tool creation with attribute-based configuration
  • Tools via classes
  • Tools via methods of AI agent class (Auto)
  • Tool facade for shortened tool creation
  • Parallel tool execution capability (can be disabled)
• Extensive Event system for agent interactions (Nearly everything is hookable)
• Multiple provider support (Can be set per model)
• Support for both Laravel and standalone usage

Planned

Here's what's coming next to make LarAgent even more powerful:

Developer Experience 🛠️

• Artisan Commands for Rapid Development
  • chat-history:clear AgentName - Clear all chat histories for a specific agent
  • make:agent:tool - Generate tool classes with ready-to-use stubs
  • make:agent:chat-history - Scaffold custom chat history implementations
  • make:llm-driver - Create custom LLM driver integrations

Enhanced AI Capabilities 🧠

• Prism Package Integration - Additional LLM providers support
• Streaming Support - Out-of-the-box support for streaming responses
• RAG & Knowledge Base
  • Built-in vector storage providers
  • Seamless document embeddings integration
  • Smart context management
• Ready-to-use Tools - Built-in tools as traits
• Structured Output at runtime - Allow defining the response JSON Schema at runtime.

Security & Storage 🔒

• Enhanced Chat History Security - Optional encryption for sensitive conversations

Advanced Integrations 🔌

• Provider Fallback System - Automatic fallback to alternative providers
• Laravel Actions Integration - Use your existing Actions as agent tools
• Voice Chat Support - Out of the box support for voice interactions with your agents

Stay tuned! We're constantly working on making LarAgent the most versatile AI agent framework for Laravel.