The Neuron AI Framework for PHP and Laravel

The Neuron AI Framework is an innovative solution designed for building production-ready AI-driven applications using PHP and Laravel. It provides developers with a robust set of tools and features that streamline the development process, making it easier to integrate artificial intelligence capabilities into their applications. This article will explore the key components of the Neuron AI Framework, its integration with Laravel, and how developers can leverage its features to create intelligent applications.

Introduction to Neuron AI Framework

Neuron AI is a PHP Agentic framework that focuses on enabling developers to create AI-driven applications efficiently. The framework is designed to be user-friendly, with a simple syntax and clear interfaces that facilitate the development of agentic systems. The core of the Neuron AI Framework is complemented by the neuron-laravel package, which provides Laravel-specific integration points without restricting access to the framework’s core components.

One of the standout features of Neuron is its ability to work seamlessly with various AI providers, allowing developers to choose the best tools for their applications. This flexibility, combined with the framework’s ease of use, makes it an attractive option for developers looking to incorporate AI into their projects.

Key Features of Neuron AI Framework

The Neuron AI Framework offers a range of features that enhance the development experience for PHP and Laravel developers. Below are some of the key features:

• Simple Syntax: The framework utilizes a straightforward syntax that allows developers to focus on building their applications without getting bogged down by complex abstractions.
• Typed Code: Neuron is built with 100% typed code, which enhances code quality and reduces the likelihood of runtime errors.
• Clear Interfaces: The framework provides clear interfaces that developers can rely on to create custom plugins and extensions, ensuring a smooth development process.
• Artisan Commands: Neuron includes several Artisan commands that enable developers to quickly generate essential files such as agents, tools, and workflows, significantly reducing boilerplate code.
• Chat History Feature: The framework includes a chat history feature that provides context for large language models (LLMs) while managing conversation length to avoid exceeding content windows.
• Customizable Storage: Developers can store chat history in various formats, including in-memory, file, or database storage, by implementing the AbstractChatHistory class.

Getting Started with Neuron AI Framework

To get started with the Neuron AI Framework, developers need to install the core framework and the neuron-laravel package. Below are the steps to set up the framework:

1. Install Neuron Core: Begin by installing the Neuron core library via Composer. This can be done by running the following command in your terminal:

composer require neuron-ai/core

2. Install Neuron Laravel Package: Next, install the neuron-laravel package to enable Laravel-specific features:

composer require neuron-ai/neuron-laravel

3. Configuration: Publish the configuration files for the Neuron package using the following Artisan command:

php artisan vendor:publish --provider="NeuronAINeuronServiceProvider"

4. Set Up AI Providers: Configure your AI provider credentials in the published configuration file to start utilizing the AI capabilities.

Creating a Neuron Agent

One of the primary components of the Neuron AI Framework is the ability to create agents. Agents are specialized classes that interact with AI providers to perform specific tasks. Below is an example of how to create a simple YouTube agent that summarizes video content:

<?php
namespace AppNeuron;

use NeuronAIAgent;
use NeuronAISystemPrompt;
use NeuronAIProvidersAIProviderInterface;
use NeuronAIProvidersAnthropicAnthropic;

class YouTubeAgent extends Agent {
    protected function provider(): AIProviderInterface {
        return new Anthropic(
            key: 'ANTHROPIC_API_KEY',
            model: 'ANTHROPIC_MODEL',
        );
    }

    public function instructions(): string {
        return (string) new SystemPrompt(
            background: ["You are an AI Agent specialized in writing YouTube video summaries."],
            steps: [
                "Get the url of a YouTube video, or ask the user to provide one.",
                "Use the tools you have available to retrieve the transcription of the video.",
                "Write the summary.",
            ],
            output: [
                "Write a summary in a paragraph without using lists. Use just fluent text.",
                "After the summary add a list of three sentences as the three most important takeaways from the video.",
            ]
        );
    }
}

In this example, the YouTubeAgent class extends the Agent class provided by the Neuron AI Framework. The provider method returns an instance of the AI provider (in this case, Anthropic), while the instructions method defines the steps the agent will follow to summarize a YouTube video.

Utilizing Chat History

The chat history feature in the Neuron AI Framework is designed to enhance user interactions by maintaining context throughout conversations. Developers can implement the chat history feature in their agents by extending the AbstractChatHistory class. This allows them to store and retrieve chat history in a way that suits their application’s needs.

Here’s how to implement a basic in-memory chat history:

<?php
namespace AppChatHistory;

use NeuronAIChatHistoryAbstractChatHistory;

class InMemoryChatHistory extends AbstractChatHistory {
    protected array $history = [];

    public function addMessage(string $message): void {
        $this->history[] = $message;
    }

    public function getHistory(): array {
        return $this->history;
    }
}

This InMemoryChatHistory class stores messages in an array, allowing the agent to access previous messages and maintain context during interactions. Developers can further customize this class to store chat history in files or databases as needed.

Integration with Laravel

The Neuron AI Framework’s integration with Laravel provides developers with a familiar environment to build AI-driven applications. The neuron-laravel package offers several Laravel-specific features, including:

• Facades: The framework includes facades that automatically instantiate AI providers and vector stores, simplifying the process of accessing AI capabilities.
• Artisan Commands: Developers can use Artisan commands to create essential components quickly, reducing the amount of boilerplate code required for new projects.
• Migrations: The framework provides ready-to-run migrations for the EloquentChatHistory component, making it easy to set up chat history storage in a Laravel application.

Best Practices for Developing with Neuron AI

When developing applications with the Neuron AI Framework, consider the following best practices to ensure a smooth development experience:

• Utilize Typed Code: Take advantage of the framework’s 100% typed code to catch errors early and improve code maintainability.
• Keep Instructions Clear: When defining instructions for agents, ensure that they are clear and concise to facilitate effective communication with the AI provider.
• Implement Robust Chat History: Choose a suitable storage method for chat history that aligns with your application’s requirements, ensuring that context is maintained throughout user interactions.
• Leverage Artisan Commands: Use the provided Artisan commands to quickly generate components and reduce repetitive coding tasks.
• Refer to Documentation: Regularly consult the official Neuron documentation for updates, best practices, and examples to enhance your development process.

Conclusion

The Neuron AI Framework for PHP and Laravel is a powerful tool for developers looking to build AI-driven applications. With its simple syntax, clear interfaces, and robust features, it provides a solid foundation for creating intelligent systems. By leveraging the integration with Laravel, developers can streamline their workflow and focus on delivering high-quality applications that harness the power of artificial intelligence.

Frequently Asked Questions

Note: The Neuron AI Framework offers a comprehensive solution for developers looking to harness the power of AI in their applications, providing tools and features that simplify the development process and enhance application functionality.