PHPackages                             astrotomic/laravel-unavatar - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. astrotomic/laravel-unavatar

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

astrotomic/laravel-unavatar
===========================

Laravel integration of unavatar service.

0.5.0(1y ago)297.9k—0%2MITPHPPHP ^8.0CI failing

Since Feb 22Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Astrotomic/laravel-unavatar)[ Packagist](https://packagist.org/packages/astrotomic/laravel-unavatar)[ Docs](https://astrotomic.info)[ Fund](https://forest.astrotomic.info)[ GitHub Sponsors](https://github.com/Gummibeer)[ RSS](/packages/astrotomic-laravel-unavatar/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (7)Versions (8)Used By (0)

Laravel Unavatar
================

[](#laravel-unavatar)

[![Latest Version](https://camo.githubusercontent.com/69779b6cb608f7cf6900d557b843b7c0d85e37879c0253ff338c39fc3a44707c/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617374726f746f6d69632f6c61726176656c2d756e6176617461722e7376673f6c6162656c3d52656c65617365267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/astrotomic/laravel-unavatar)[![MIT License](https://camo.githubusercontent.com/2aa76a46794bacd4e1b2ceb13b27f1144af71ee7d374bfd1bdf2e6cd0ea32648/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f417374726f746f6d69632f6c61726176656c2d756e6176617461722e7376673f6c6162656c3d4c6963656e736526636f6c6f723d626c7565267374796c653d666f722d7468652d6261646765)](https://github.com/Astrotomic/laravel-unavatar/blob/master/LICENSE)[![Offset Earth](https://camo.githubusercontent.com/d204555ebe1fb0ae82d10c97b4f4ffc2dfdd2ba1489f98be7f7e8708333a0466/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54726565776172652d2546302539462538432542332d677265656e3f7374796c653d666f722d7468652d6261646765)](https://plant.treeware.earth/Astrotomic/laravel-unavatar)[![Larabelles](https://camo.githubusercontent.com/a2c8d5126ddd8c5ddc627176d1d2e0568f8399b50038e71fd7f774c3e24dbe4b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726162656c6c65732d2546302539462541362538342d6c6967687470696e6b3f7374796c653d666f722d7468652d6261646765)](https://www.larabelles.com/)

[![GitHub Workflow Status](https://camo.githubusercontent.com/3a7166993c3f458585b7120d273e201fcff6a9575ded995ca9904e64eb8c9be7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f417374726f746f6d69632f6c61726176656c2d756e6176617461722f72756e2d74657374733f7374796c653d666c61742d737175617265266c6f676f436f6c6f723d7768697465266c6f676f3d676974687562266c6162656c3d5465737473)](https://github.com/Astrotomic/laravel-unavatar/actions?query=workflow%3Arun-tests)[![StyleCI](https://camo.githubusercontent.com/e1a01bb08b9ab27d76328ad5d4694ed3b616b6e38a1934649f9396cbf7a6f96e/68747470733a2f2f7374796c6563692e696f2f7265706f732f3234323231373534342f736869656c64)](https://styleci.io/repos/242217544)[![Total Downloads](https://camo.githubusercontent.com/d5abb2beae1d9fc4b1a559e817983528203350661141d53c031b8720712a0876/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617374726f746f6d69632f6c61726176656c2d756e6176617461722e7376673f6c6162656c3d446f776e6c6f616473267374796c653d666c61742d737175617265)](https://packagist.org/packages/astrotomic/laravel-unavatar)

This package provides a Laravel wrapper for [unavatar](https://unavatar.now.sh).

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

[](#installation)

You can install the package via composer:

```
composer require astrotomic/laravel-unavatar
php artisan vendor:publish --provider="Astrotomic\LaravelUnavatar\UnavatarServiceProvider" --tag=config
```

Usage
-----

[](#usage)

Most of the logic and possibilities is inherited from the [astrotomic/php-unavatar](https://github.com/Astrotomic/php-unavatar) base package. On top this package adds some Laravel specific possibilities. The `\Astrotomic\LaravelUnavatar\Unavatar` class implements several interfaces:

- `\Illuminate\Contracts\Support\Renderable`
- `\Illuminate\Contracts\Support\Responsable`
- `\Illuminate\Contracts\Support\Htmlable`
- `\Illuminate\Contracts\Support\Jsonable`
- `\JsonSerializable`
- `\Illuminate\Contracts\Support\Arrayable`

So you can use the use your `Unavatar` instances in your controllers as response but for sure also in your views. The last three ones will use the [unavatar](https://unavatar.now.sh) JSON API - so they will start a HTTP request.

### Blade Component

[](#blade-component)

The package provides a blade component you can use in your views.

```

```

You can also publish the used view and customize it.

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](https://github.com/Astrotomic/.github/blob/master/CONTRIBUTING.md) for details. You could also be interested in [CODE OF CONDUCT](https://github.com/Astrotomic/.github/blob/master/CODE_OF_CONDUCT.md).

### Security

[](#security)

If you discover any security related issues, please check [SECURITY](https://github.com/Astrotomic/.github/blob/master/SECURITY.md) for steps to report it.

Credits
-------

[](#credits)

- [Tom Witkowski](https://github.com/Gummibeer)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

Treeware
--------

[](#treeware)

You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree.

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.

You can buy trees at [offset.earth/treeware](https://plant.treeware.earth/Astrotomic/laravel-unavatar)

Read more about Treeware at [treeware.earth](https://treeware.earth)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.8% 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 ~264 days

Recently: every ~320 days

Total

7

Last Release

692d ago

PHP version history (3 changes)0.1.0PHP ^7.1

0.2.0PHP ^7.4 || ^8.0

0.5.0PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6187884?v=4)[Tom Herrmann](/maintainers/Gummibeer)[@Gummibeer](https://github.com/Gummibeer)

---

Top Contributors

[![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (67 commits)")[![marcusmyers](https://avatars.githubusercontent.com/u/337947?v=4)](https://github.com/marcusmyers "marcusmyers (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![jamesmills](https://avatars.githubusercontent.com/u/557096?v=4)](https://github.com/jamesmills "jamesmills (1 commits)")

---

Tags

avatarclearbitdeviantartfacebookgitthubgravatarhacktoberfestinstagramlaravel-unavatarsoundcloudtelegramtreewaretwitterunavataryoutubelaravelavatarastrotomicunavatarlaravel-unavatar

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/astrotomic-laravel-unavatar/health.svg)

```
[![Health](https://phpackages.com/badges/astrotomic-laravel-unavatar/health.svg)](https://phpackages.com/packages/astrotomic-laravel-unavatar)
```

###  Alternatives

[yajra/laravel-datatables-oracle

jQuery DataTables API for Laravel

4.9k33.8M339](/packages/yajra-laravel-datatables-oracle)[laravolt/avatar

Turn name, email, and any other string into initial-based avatar or gravatar.

2.0k5.4M31](/packages/laravolt-avatar)[cknow/laravel-money

Laravel Money

1.0k4.3M22](/packages/cknow-laravel-money)[livewire/flux

The official UI component library for Livewire.

9475.0M86](/packages/livewire-flux)[akaunting/laravel-money

Currency formatting and conversion package for Laravel

7825.3M18](/packages/akaunting-laravel-money)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)

PHPackages © 2026

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