jordan-price/toolbox

A Laravel package providing various tools including calculator, weather, email, time, and cryptocurrency tools

dev-main 2025-02-22 02:06 UTC

Requires

• php: ^8.1
• echolabsdev/prism: ^0.3
• laravel/framework: ^10.0|^11.0
• livewire/livewire: ^3.0

MIT

• Jordan Price

README

A collection of AI-powered tools designed to work with Laravel applications.

Features

• Weather: Get real-time weather data and forecasts
• Time: Handle time operations and timezone conversions
• Crypto: Fetch cryptocurrency price information
• Email: Send emails with ease
• Eloquent: Execute database queries using natural language

Installation

You can install the package via composer:

composer require jordan-price/toolbox

Publish the configuration file:

php artisan vendor:publish --tag="toolbox-config"

Configuration

After installation, you can configure the package in your .env file:

# Weather Tool (optional)
WEATHER_API_KEY=your_api_key

Usage

Weather

Get real-time weather data:

use JordanPrice\Toolbox\Tools\Weather\WeatherTool;
use EchoLabs\Prism\Prism;
use EchoLabs\Prism\Enums\Provider;
use EchoLabs\Prism\Enums\ToolChoice;

$weatherTool = new WeatherTool();

$prism = Prism::text()
    ->using(Provider::Anthropic, 'claude-3-5-sonnet-latest')
    ->withPrompt('What is the weather in London?')
    ->withTools([$weatherTool])  // Pass the tool instance
    ->toolChoice(ToolChoice::Any);

$response = $prism->generate();

Time

Handle time operations:

use JordanPrice\Toolbox\Tools\Time\TimeTool;
use EchoLabs\Prism\Prism;
use EchoLabs\Prism\Enums\Provider;
use EchoLabs\Prism\Enums\ToolChoice;

$timeTool = new TimeTool();

$prism = Prism::text()
    ->using(Provider::Anthropic, 'claude-3-5-sonnet-latest')
    ->withPrompt('What time is it in New York?')
    ->withTools([$timeTool])
    ->toolChoice(ToolChoice::Any);

$response = $prism->generate();

Crypto

Get cryptocurrency prices:

use JordanPrice\Toolbox\Tools\Crypto\CryptoTool;
use EchoLabs\Prism\Prism;
use EchoLabs\Prism\Enums\Provider;
use EchoLabs\Prism\Enums\ToolChoice;

$cryptoTool = new CryptoTool();

$prism = Prism::text()
    ->using(Provider::Anthropic, 'claude-3-5-sonnet-latest')
    ->withPrompt('What is the current price of Bitcoin?')
    ->withTools([$cryptoTool])
    ->toolChoice(ToolChoice::Any);

$response = $prism->generate();

Email

Send emails:

use JordanPrice\Toolbox\Tools\Email\EmailTool;
use EchoLabs\Prism\Prism;
use EchoLabs\Prism\Enums\Provider;
use EchoLabs\Prism\Enums\ToolChoice;

$emailTool = new EmailTool();

$prism = Prism::text()
    ->using(Provider::Anthropic, 'claude-3-5-sonnet-latest')
    ->withPrompt('Send a welcome email to [e-mail]')
    ->withTools([$emailTool])
    ->toolChoice(ToolChoice::Any);

$response = $prism->generate();

Eloquent

Execute database queries:

use JordanPrice\Toolbox\Tools\Eloquent\EloquentTool;
use EchoLabs\Prism\Prism;
use EchoLabs\Prism\Enums\Provider;
use EchoLabs\Prism\Enums\ToolChoice;

$eloquentTool = new EloquentTool();

$prism = Prism::text()
    ->using(Provider::Anthropic, 'claude-3-5-sonnet-latest')
    ->withPrompt('Find all active users')
    ->withTools([$eloquentTool])
    ->toolChoice(ToolChoice::Any);

$response = $prism->generate();

Contributing

Please see CONTRIBUTING.md for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Jordan Price
• All Contributors

License

The MIT License (MIT). Please see License File for more information.