PHPackages                             shale-php/shale - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. shale-php/shale

ActiveLibrary

shale-php/shale
===============

A package for interacting with the Amazon Bedrock service

v0.11(1y ago)12MITPHPPHP ^8.3

Since Mar 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/shale-php/shale)[ Packagist](https://packagist.org/packages/shale-php/shale)[ RSS](/packages/shale-php-shale/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (9)Versions (3)Used By (0)

Shale
=====

[](#shale)

Shale is a package to interact with AWS Bedrock, a service that provides a way to interact with LLMs (Large Language Models) in a secure and scalable way within the AWS infrastructure. You can learn more about Amazon Bedrock [here](https://aws.amazon.com/bedrock/).

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require shale-php/shale
```

Next, publish the configuration file:

```
php artisan vendor:publish --tag=shale-config
```

This will auto discover the package and you can start using it straight away.

Usage
-----

[](#usage)

First make sure you have the following environment variables set in your Laravel application:

```
AWS_DEFAULT_REGION=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
```

Next make sure you have requested access to the bedrock models you want to use in your region within your AWS console.

You can then use the following code to interact with the bedrock model:

```
$question = 'What is the capital of France?';

$claudeReply = Shale::using(Claude3::make())
    ->prompt($question)
    ->execute();

$AI21LabsReply = Shale::using(AI21LabsJamba15Mini::make())
    ->prompt($question)
    ->execute();

// The capital of France is Paris.
```

Authors
-------

[](#authors)

This library was created by [Richard Bagshaw](https://www.richardbagshaw.co.uk).

License
-------

[](#license)

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

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance45

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

431d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/825428?v=4)[Richard Bagshaw](/maintainers/bagwaa)[@bagwaa](https://github.com/bagwaa)

---

Top Contributors

[![bagwaa](https://avatars.githubusercontent.com/u/825428?v=4)](https://github.com/bagwaa "bagwaa (27 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/shale-php-shale/health.svg)

```
[![Health](https://phpackages.com/badges/shale-php-shale/health.svg)](https://phpackages.com/packages/shale-php-shale)
```

###  Alternatives

[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11320.2M21](/packages/anourvalar-eloquent-serialize)[georgeboot/laravel-echo-api-gateway

Use Laravel Echo with API Gateway Websockets

10435.5k](/packages/georgeboot-laravel-echo-api-gateway)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)