Lar Agent

Abstract

1. Introduction

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.

LarAgent is an AI agent development framework for Laravel Officially powered by Redberry, a Diamond-tier Laravel partner.

LarAgent is an open-source framework that lets you create powerful AI agents in Laravel with minimal configuration and maximum extensibility.

2. Objective

Power of AI Agents in your Laravel project

This project demonstrates how PHP, Laravel can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• 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

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• PHP 7.4+ with a web server (XAMPP / WAMP / LAMP)
• MySQL / MariaDB
• phpMyAdmin (optional)
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/MaestroError/LarAgent.git
cd LarAgent

composer require maestroerror/laragent

php artisan vendor:publish --tag="laragent-config"

return [
    'default_driver' => \LarAgent\Drivers\OpenAi\OpenAiDriver::class,
    'default_chat_history' => \LarAgent\History\InMemoryChatHistory::class,

    'providers' => [

        'default' => [
            'label' => 'openai',
            'api_key' => env('OPENAI_API_KEY'),
            'default_truncation_threshold' => 50000,
            'default_max_completion_tokens' => 100,
            'default_temperature' => 1,
        ],
    ],
];

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by MaestroError and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.