> For the complete documentation index, see [llms.txt](https://vibemx.gitbook.io/neuronai-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vibemx.gitbook.io/neuronai-studio/reference/artisan-commands.md).

# Artisan Commands

NeuronAI Studio registers the following Artisan commands.

## neuronai-studio:install

Install the package — publish config, migrations, and assets.

```bash
php artisan neuronai-studio:install
php artisan neuronai-studio:install --force
php artisan neuronai-studio:install --with-views
```

| Option         | Description                                    |
| -------------- | ---------------------------------------------- |
| `--force`      | Overwrite existing published config/migrations |
| `--with-views` | Publish Blade views for customization          |

See [Installation](/neuronai-studio/getting-started/installation.md).

## neuronai-studio:export

Export studio definitions to PHP classes.

```bash
php artisan neuronai-studio:export agent {id}
php artisan neuronai-studio:export workflow {id}
```

Output path: `config('neuronai-studio.export_path')` (default `app/Neuron`).

Tools are exported from the studio UI (**Export PHP** button in the tool editor), not via CLI.

See [Export & Production](/neuronai-studio/workflows/export-and-production.md).

## neuronai-studio:make-tool

Scaffold a Neuron Tool PHP class.

```bash
php artisan neuronai-studio:make-tool {name}
```

Example:

```bash
php artisan neuronai-studio:make-tool WeatherLookup
```

See [Make Tool CLI](/neuronai-studio/tools/make-tool-cli.md).

## neuronai-studio:evaluations

Run NeuronAI evaluators discovered in a directory. Delegates to NeuronAI's `EvaluatorDiscovery` and `EvaluatorRunner`.

```bash
php artisan neuronai-studio:evaluations
php artisan neuronai-studio:evaluations --path=evaluators
php artisan neuronai-studio:evaluations --path=evaluators --verbose
```

| Option      | Description                                                    |
| ----------- | -------------------------------------------------------------- |
| `--path`    | Directory containing evaluator classes (default: `evaluators`) |
| `--verbose` | Show evaluator names during execution                          |

Output drivers are configured in `evaluation.php` at the project root. Publish the stub:

```bash
php artisan vendor:publish --tag=neuronai-studio-evaluation
```

See [Evaluations](/neuronai-studio/agents/evaluations.md).

## neuronai-studio:eval

Run an eval suite stored in the database against its linked agent.

```bash
php artisan neuronai-studio:eval {suite}
php artisan neuronai-studio:eval support-basic
php artisan neuronai-studio:eval 1 --fake
```

| Argument / Option | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| `{suite}`         | Eval suite ID or slug                                                               |
| `--fake`          | Use `FakeAIProvider` for the agent under test only (judge still uses real provider) |

Exit code is non-zero when any case fails. Results are persisted to `eval_runs` and `eval_run_items`.

See [Evaluations](/neuronai-studio/agents/evaluations.md).

## neuronai-studio:install-observability

Print an env-first checklist for external monitoring (Inspector or Langfuse).

```bash
php artisan neuronai-studio:install-observability inspector
php artisan neuronai-studio:install-observability langfuse
```

Does not write `.env` or secrets. See [Inspector](https://github.com/digitalelvis/neuronai-studio/tree/main/docs/guides/observability/inspector.md) and [Langfuse](https://github.com/digitalelvis/neuronai-studio/tree/main/docs/guides/observability/langfuse.md).

## Related Neuron AI commands

NeuronAI Studio depends on [neuron-core/neuron-ai](https://docs.neuron-ai.dev/overview/getting-started). Provider credentials are configured in `config/neuron.php` (published by `neuronai-studio:install`).

```bash
# Optional — re-publish provider config
php artisan vendor:publish --tag=neuron-config
```

## Queue worker (async workflow runs)

When `NEURONAI_STUDIO_ASYNC_RUNS_ENABLED=true`, workflow runs and HITL resumes are processed by Laravel queue jobs. A worker must be running:

```bash
php artisan queue:work --queue=default
```

Use the queue name from `NEURONAI_STUDIO_QUEUE` (default `default`). See [Runtime & Traces](/neuronai-studio/workflows/runtime-and-traces.md#queue-runner).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://vibemx.gitbook.io/neuronai-studio/reference/artisan-commands.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.