README

Bring the power of LLMs to your PHP application—without the bloat.

NanoAgent is a lightweight library designed to strip away the complexity of modern AI development. While other libraries force you into steep learning curves, massive dependency trees, and rigid architectural patterns, NanoAgent takes a different approach: simplicity as a feature.

Whether you are building a complex autonomous agent or just need to integrate smart decision-making into a project, NanoAgent lets you focus on the task, not the configuration.

Why NanoAgent?

The AI landscape is filled with "everything-included" frameworks that are often too heavy for practical, day-to-day PHP development.

• Stop wrestling with complex configurations: No need to learn a new DSL (Domain-Specific Language) or manage a dozen config files.
• Drop-in ready: Works with Laravel, Symfony, Slim, or plain PHP scripts.
• Zero friction: Go from composer install to a working agent in minutes.

Features

• ⚡ Adaptable: Seamlessly switch between OpenAI, Groq, Anthropic, DeepSeek, and OpenRouter with a single line of config.
• 🛠️ Tool-First Architecture: Give your AI "hands." Easily map PHP functions as tools that your agent can intelligently execute to interact with your database, APIs, or filesystem.
• 🎯 Goal-Oriented Execution: Define clear, context-aware tasks. The agent handles the reasoning, you handle the results.
• 💎 Minimalist Design: A tiny footprint with massive potential. Use only what you need, with no hidden magic.

🚀 Quick Start

This guide provides step-by-step instructions for installing, configuring, and running the NanoAgent PHP library in any PHP environment.

Prerequisites

• PHP 8.0 or higher
• Composer installed globally

📦 Installation & Setup

1. Initialize a project:

   mkdir my-agent-project && cd my-agent-project
   composer require hammrouni/nanoagent

2. Configuration : Create config.php (copy the example from NanoAgent/config.php.example) in the project root to manage credentials.

   // config.php
   return [
       // API Key
       'api_key' => 'your_api_key_here',
       
       // AI Provider (groq, openai, anthropic, etc.)
       'provider' => '',
       
       // Model to use
       'model' => '',
   ];

   Then usage becomes:

   // index.php
   $config = require __DIR__ . '/config.php';
   
   $agent = new Agent(
       llm: $config
       // ... other parameters
   );

3. Troubleshooting

• Class not found: Run composer dump-autoload to regenerate the autoload files.
• API Error: Check config.php or your environment variables to ensure the API key is correct.
• PHP Version: Ensure you are running PHP 8.0+ by checking php -v.

🛠️ Advanced Usage: Tools

Give your agent "hands" by defining tools.

use NanoAgent\Tools\FunctionTool;

$calculator = new FunctionTool(
    name: 'calculator',
    description: 'Add two numbers',
    parameters: [
        'type' => 'object',
        'properties' => [
            'a' => ['type' => 'integer', 'description' => 'First number'],
            'b' => ['type' => 'integer', 'description' => 'Second number']
        ],
        'required' => ['a', 'b']
    ],
    callable: fn(array $args) => $args['a'] + $args['b']
);

$agent = new Agent(
    llm: [...], 
    tools: [$calculator]
);

📂 Examples

Check the examples/ directory for advanced use cases:

Supported Providers

• Groq
• OpenAI (not tested)
• OpenRouter (not tested)
• Anthropic (not tested)
• DeepSeek (not tested)

License

MIT