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. [API Development](/categories/api)
4. /
5. shale-php/shale

ActiveLibrary[API Development](/categories/api)

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 1w 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

25

—

LowBetter than 35% of packages

Maintenance39

Infrequent updates — may be unmaintained

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

523d 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

[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

11.3k4.0k](/packages/leantime-leantime)[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.2k](/packages/statamic-cms)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3622.8k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

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