PHPackages                             finity-labs/fin-avatar - 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. finity-labs/fin-avatar

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

finity-labs/fin-avatar
======================

Privacy-focused SVG avatar generator for Filament.

v1.1.0(2mo ago)45.0k↑47.5%2MITPHPPHP ^8.2CI passing

Since Jan 25Pushed 2mo agoCompare

[ Source](https://github.com/finity-labs/fin-avatar)[ Packagist](https://packagist.org/packages/finity-labs/fin-avatar)[ RSS](/packages/finity-labs-fin-avatar/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (4)Dependencies (8)Versions (5)Used By (0)

FinAvatar for Filament
======================

[](#finavatar-for-filament)

[![finity-labs-fin-avatar](https://private-user-images.githubusercontent.com/254747167/541144072-6b8a879c-afe1-4856-b69d-c76188c1c96e.jpg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2ODQwMjQsIm5iZiI6MTc4MjY4MzcyNCwicGF0aCI6Ii8yNTQ3NDcxNjcvNTQxMTQ0MDcyLTZiOGE4NzljLWFmZTEtNDg1Ni1iNjlkLWM3NjE4OGMxYzk2ZS5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMTU1MjRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT01OGRmZjg3Njk2MDY4NDRhYjdiNzgwMzMyOGU2MmQzM2ExNDhjMDlmZmI1YmRhOTk3NDM4Mjg5ZjIxNmQ0NWIzJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZqcGVnIn0.nmlXdEr3X837LLNofraPBunIPa6EdhlyFex3p-AoWmo)](https://private-user-images.githubusercontent.com/254747167/541144072-6b8a879c-afe1-4856-b69d-c76188c1c96e.jpg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2ODQwMjQsIm5iZiI6MTc4MjY4MzcyNCwicGF0aCI6Ii8yNTQ3NDcxNjcvNTQxMTQ0MDcyLTZiOGE4NzljLWFmZTEtNDg1Ni1iNjlkLWM3NjE4OGMxYzk2ZS5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMTU1MjRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT01OGRmZjg3Njk2MDY4NDRhYjdiNzgwMzMyOGU2MmQzM2ExNDhjMDlmZmI1YmRhOTk3NDM4Mjg5ZjIxNmQ0NWIzJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZqcGVnIn0.nmlXdEr3X837LLNofraPBunIPa6EdhlyFex3p-AoWmo)

[![FILAMENT 4.x](https://camo.githubusercontent.com/5b4c0b6fdfb4549d1f307a81659b179a61d677a1849d35e6ecabd4879b602ea5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46494c414d454e542d342e782d4542423330343f7374796c653d666c61742d737175617265)](https://filamentphp.com/docs/4.x/panels/installation)[![FILAMENT 5.x](https://camo.githubusercontent.com/505caf6f77dd8ce71275a65163d71c3d96731f079069e1ff8a7d5d2a3c07d8a3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46494c414d454e542d352e782d4542423330343f7374796c653d666c61742d737175617265)](https://filamentphp.com/docs/5.x/panels/installation)[![Latest Version on Packagist](https://camo.githubusercontent.com/6b07f692abe97fa4032e940b6293b4bf963fe8b988e23dcf467b9c42ab043771/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696e6974792d6c6162732f66696e2d6176617461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/finity-labs/fin-avatar)[![Tests](https://github.com/finity-labs/fin-avatar/actions/workflows/tests.yml/badge.svg)](https://github.com/finity-labs/fin-avatar/actions/workflows/tests.yml)[![Code Style](https://github.com/finity-labs/fin-avatar/actions/workflows/style.yml/badge.svg)](https://github.com/finity-labs/fin-avatar/actions/workflows/style.yml)[![Total Downloads](https://camo.githubusercontent.com/6c5f921328ae423516d3798ea642a21b67846d87d596558b571fc2194b2d67ac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66696e6974792d6c6162732f66696e2d6176617461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/finity-labs/fin-avatar)[![License](https://camo.githubusercontent.com/31b9a5a6f49e812c4bf46e4b4aecb6a0b238ed180b51ddc4ad278bbab6bb682f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f66696e6974792d6c6162732f66696e2d6176617461722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/finity-labs/fin-avatar)

A privacy-focused, high-performance avatar provider for Filament V4 and V5. It generates SVGs locally using a dedicated route, ensuring **zero external requests** (GDPR compliant) and utilizing **browser caching** for instant loads.

Features
--------

[](#features)

- Zero External APIs: No data sent to ui-avatars.com or Gravatar.
- Smart Initials: Automatically strips "Mr.", "Dr.", "PhD" etc.
- Theme Aware: Uses your Filament Panel's primary color automatically.
- High Performance: SVGs are cached by the browser for 1 year.

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

[](#installation)

You can install the package via composer:

```
composer require finity-labs/fin-avatar
```

Running the install command will configure the selected panels automatically:

```
php artisan finity-labs:install
```

Usage
-----

[](#usage)

Add in AdminPanelProvider.php:

```
use FinityLabs\FinAvatar\AvatarProviders\UiAvatarsProvider;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->defaultAvatarProvider(UiAvatarsProvider::class);
}
```

Configuration (Optional)
------------------------

[](#configuration-optional)

Publish the config file to customize ignored prefixes (like "Mr", "Dr"), default background color and text color:

```
php artisan vendor:publish --tag=fin-avatar-config
```

💡 `Note: Leave default_bg null to use theme color as background.`

Credits
-------

[](#credits)

- [Finity Labs](https://github.com/finity-labs)

License
-------

[](#license)

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

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance85

Actively maintained with recent releases

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90% 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 ~26 days

Total

4

Last Release

80d ago

Major Versions

v0.2.1 → v1.0.02026-01-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/7106a5652821f312e3e0f1541d41defe67b73cf5b5f5cb6641f10c7412475eed?d=identicon)[Finity Labs](/maintainers/Finity%20Labs)

---

Top Contributors

[![finity-labs](https://avatars.githubusercontent.com/u/254747167?v=4)](https://github.com/finity-labs "finity-labs (18 commits)")[![jinbatsu](https://avatars.githubusercontent.com/u/103924?v=4)](https://github.com/jinbatsu "jinbatsu (1 commits)")[![webard](https://avatars.githubusercontent.com/u/855788?v=4)](https://github.com/webard "webard (1 commits)")

---

Tags

avatarfilamentlaravelphpprivacysvglaravelsvgavatarfilamentprivacy

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/finity-labs-fin-avatar/health.svg)

```
[![Health](https://phpackages.com/badges/finity-labs-fin-avatar/health.svg)](https://phpackages.com/packages/finity-labs-fin-avatar)
```

###  Alternatives

[ysfkaya/filament-phone-input

A phone input component for Laravel Filament

3161.3M24](/packages/ysfkaya-filament-phone-input)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122177.8k1](/packages/stephenjude-filament-feature-flags)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6649.5k1](/packages/marcelweidum-filament-passkeys)

PHPackages © 2026

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