php artisan instructor:install
# @doctest id="4239"

Installing Instructor for Laravel...

Publishing configuration... done
Checking API key configuration... ✓

Next steps:

  1. Configure your API keys in .env:
     OPENAI_API_KEY=your-key-here

  2. Create a response model:
     php artisan make:response-model PersonData

  3. Extract structured data:
     $person = StructuredOutput::with(
         messages: "John is 30 years old",
         responseModel: PersonData::class,
     )->get();

  4. Test your installation:
     php artisan instructor:test

Instructor installed successfully!
// @doctest id="d99e"

php artisan instructor:test
# @doctest id="f043"

# Test default connection
php artisan instructor:test

# Test specific connection
php artisan instructor:test --preset=anthropic

# Test raw inference
php artisan instructor:test --inference
# @doctest id="e1ec"

Testing Instructor installation...

Preset ............................................. openai
Driver ............................................. openai
Model .............................................. gpt-4o-mini
API Key ............................................ sk-...abc ✓

Testing structured output extraction... ✓

Structured output test completed!
// @doctest id="d167"

php artisan make:response-model {name}
# @doctest id="88f1"

php artisan make:response-model PersonData
# @doctest id="8d7a"

<?php

declare(strict_types=1);

namespace App\ResponseModels;

/**
 * TODO: Add description for this response model
 */
final class PersonData
{
    public function __construct(
        /** The name of the person */
        public readonly string $name,

        /** The age of the person in years */
        public readonly int $age,

        /** Optional email address */
        public readonly ?string $email = null,
    ) {}
}
// @doctest id="8c03"

php artisan make:response-model ProductList --collection
# @doctest id="e7f8"

final class ProductList
{
    public function __construct(
        /** List of extracted items */
        public readonly array $items,
    ) {}
}

final class ProductListItem
{
    public function __construct(
        public readonly string $name,
        public readonly ?string $description = null,
    ) {}
}
// @doctest id="b351"

php artisan make:response-model CompanyProfile --nested
# @doctest id="3043"

final class CompanyProfile
{
    public function __construct(
        public readonly string $title,
        public readonly CompanyProfileContact $contact,
        public readonly ?CompanyProfileAddress $address = null,
    ) {}
}

final class CompanyProfileContact
{
    public function __construct(
        public readonly string $name,
        public readonly string $email,
        public readonly ?string $phone = null,
    ) {}
}

final class CompanyProfileAddress
{
    public function __construct(
        public readonly string $street,
        public readonly string $city,
        public readonly string $country,
        public readonly ?string $postalCode = null,
    ) {}
}
// @doctest id="7a5f"

php artisan make:response-model Invoice --description="Represents an invoice extracted from PDF documents"
# @doctest id="e48e"

php artisan vendor:publish --tag=instructor-stubs
# @doctest id="4154"

stubs/instructor/
├── response-model.stub
├── response-model.collection.stub
└── response-model.nested.stub
// @doctest id="0207"

// app/Console/Commands/ExtractInvoiceCommand.php
namespace App\Console\Commands;

use App\ResponseModels\InvoiceData;
use Cognesy\Instructor\Laravel\Facades\StructuredOutput;
use Illuminate\Console\Command;

class ExtractInvoiceCommand extends Command
{
    protected $signature = 'invoice:extract {file}';
    protected $description = 'Extract invoice data from a file';

    public function handle(): int
    {
        $content = file_get_contents($this->argument('file'));

        $invoice = StructuredOutput::with(
            messages: $content,
            responseModel: InvoiceData::class,
        )->get();

        $this->info("Invoice Number: {$invoice->number}");
        $this->info("Amount: \${$invoice->amount}");
        $this->info("Due Date: {$invoice->dueDate}");

        return self::SUCCESS;
    }
}
// @doctest id="0c6e"