Download the PHP package neuron-core/maestro without Composer

On this page you can find all versions of the php package neuron-core/maestro. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of neuron-core/maestro

Informations about the package maestro

Maestro - The First CLI Agent built in PHP

Maestro is the first CLI agent built entirely in PHP with the Neuron AI framework. It brings powerful agentic capabilities to the PHP ecosystem through an elegant CLI tool that combines intelligent analysis with interactive tool approval.

PHP

[!IMPORTANT] Get early access to new features, exclusive tutorials, and expert tips for building AI agents in PHP. Join a community of PHP developers pioneering the future of AI development. Subscribe to the newsletter

Before moving on, support the community giving a GitHub star ⭐️. Thank you!

About Maestro

While most CLI agents are written in Python or TypeScript, Maestro demonstrates that PHP can deliver a world-class AI experience. Built on the modern Neuron AI framework, Maestro provides:

Full Introduction

For a full introduction to the project architecture, you can read the article below:

https://inspector.dev/maestro-a-customizable-cli-agent-built-in-php/

Requirements

Installation

If you are on a Windows machine, you should install and run Maestro in a WSL environment.

Install Maestro globally to use it in any project:

Ensure Composer's global bin directory is in your shell profile. Run echo $0 to find the current shell.

bash

zsh

Future Updates

To keep the tool up to date, run the global update:

Configuration

When you run Maestro on a filesystem directory for the first time, it will ask you to configure your AI provider and API key.

It will start an interactive setup wizard that guides you through the configuration process.

Anthropic

Ollama

For all supported providers you can check out the Neuron AI documentation: https://docs.neuron-ai.dev/providers/ai-provider

Context File Configuration

You can provide project-specific instructions by adding a context_file setting. The agent will load this file and append its content to its system instructions.

If no context_file is specified, the agent will look for Agents.md in the project root. If the file doesn't exist, no additional context is attached.

MCP Servers

Add Model Context Protocol servers to extend the agent's capabilities:

Note: The .maestro/settings.json file should be located in your current working directory when running maestro.

Usage

Start an interactive chat session:

Tool Approval

When the agent proposes a tool operation, you'll be prompted to approve it. The human-in-the-loop system is powered by the Neuron AI Tool Approval middleware.

You can Choose from:

Monitoring Maestro sessions

Neuron AI is natively integrated with Inspector, allowing you to monitor and analyze your AI coding sessions. To enable agent monitoring you just need to add the inspector_key field to your .maestro/settings.json file:

You can get an INSPECTOR_INGESTION_KEY from the Inspector dashboard.

Extension Architecture

Maestro's extension system is the primary customization layer. Extensions are PHP classes that implement ExtensionInterface and register components through a single ExtensionApi object injected at boot time.

How it works

At startup, the ExtensionLoader builds a set of shared registries (tools, commands, renderers, events, memories, UI) and wires them into an ExtensionApi instance. Each extension's register() method is called with that API, allowing it to push into any registry. The agent then reads from those registries for the rest of the session.

Extension components

Component API method Purpose
AI Tools registerTool() New capabilities the agent can invoke (filesystem, HTTP, etc.)
Inline Commands registerCommand() /slash commands available in the interactive console
Renderers registerRenderer() Custom terminal output for a specific tool's result
Event Handlers on() React to agent lifecycle events (thinking, response, tool approval)
Memory Files registerMemory() Markdown files injected into the agent's system prompt
UI / Widgets registerWidget(), ui() Slots, themes, and widgets for terminal interface customization

Minimal extension

Discovery and loading

Extensions can be loaded two ways:

Settings always take precedence over the manifest, allowing users to override enabled status and pass configuration to any extension.

For a comprehensive guide covering packaging, auto-discovery, UI customization, and all available APIs, see the Extension README.

This repository also includes the skills directory to provide detailed instructions to AI coding assistants for extension development.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the FSL License - see the LICENSE file for details.

Credits

Built with:

Made with ❤️ by Inspector team

All versions of maestro with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
neuron-core/neuron-ai Version ^3.0
symfony/console Version ^8.0
psr/event-dispatcher Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package neuron-core/maestro contains the following files

Loading the files please wait ...