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

ActiveLibrary

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

Privacy-focused SVG avatar generator for Filament.

v1.1.0(3mo ago)41.5k↓20%1MITPHPPHP ^8.2CI passing

Since Jan 25Pushed 1mo 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 1mo ago

READMEChangelog (4)Dependencies (9)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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUzMzM2MDEsIm5iZiI6MTc3NTMzMzMwMSwicGF0aCI6Ii8yNTQ3NDcxNjcvNTQxMTQ0MDcyLTZiOGE4NzljLWFmZTEtNDg1Ni1iNjlkLWM3NjE4OGMxYzk2ZS5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNDA0JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDQwNFQyMDA4MjFaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT03NWYwYjBhMjc1YzZjN2FmMzRjYWE1Y2MwZWJmYTVhY2Q2OWE2MjgxYTE1NWM5NDBkMDkwYzllYjUyZmZlNjM5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.bRQ58eC8ciPwpeg7k468xgw1Z46ln0fEJ1ppfyGwOaY)](https://private-user-images.githubusercontent.com/254747167/541144072-6b8a879c-afe1-4856-b69d-c76188c1c96e.jpg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUzMzM2MDEsIm5iZiI6MTc3NTMzMzMwMSwicGF0aCI6Ii8yNTQ3NDcxNjcvNTQxMTQ0MDcyLTZiOGE4NzljLWFmZTEtNDg1Ni1iNjlkLWM3NjE4OGMxYzk2ZS5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNDA0JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDQwNFQyMDA4MjFaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT03NWYwYjBhMjc1YzZjN2FmMzRjYWE1Y2MwZWJmYTVhY2Q2OWE2MjgxYTE1NWM5NDBkMDkwYzllYjUyZmZlNjM5JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.bRQ58eC8ciPwpeg7k468xgw1Z46ln0fEJ1ppfyGwOaY)

[![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

46

—

FairBetter than 93% of packages

Maintenance86

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.1% 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 ~4 days

Total

4

Last Release

100d 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 (16 commits)")[![jinbatsu](https://avatars.githubusercontent.com/u/103924?v=4)](https://github.com/jinbatsu "jinbatsu (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

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[mwguerra/filemanager

A full-featured file manager package for Laravel and Filament v5 with dual operating modes, drag-and-drop uploads, S3/MinIO support, and comprehensive security features.

718.5k1](/packages/mwguerra-filemanager)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)

PHPackages © 2026

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