KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

initials-avatar

★ 43 Open GitHub ↗

Generate an avatar image from a user's initials, ideal for use as a meaningful gravatar fallback.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Initials Avatar
---------------

Generate an avatar image from a user's initials, ideal for use as a meaningful gravatar fallback. For example:

## Usage

### Basic Usage

Generate a 100x100 avatar for the initials *JD*:

```
http://initials.me/jd
```

![Basic avatar](https://raw.githubusercontent.com/loopj/initials-avatar/master/examples/jd.png)

### Specifying Size

Generate an 50x50 avatar for the initials *JS*:

```
http://initials.me/js?s=50
```

![50x50 avatar](https://raw.githubusercontent.com/loopj/initials-avatar/master/examples/js-50.png)

### Specifying Colors

Generate an avatar with custom foreground/background colors:

```
http://initials.me/js?s=50&fg=336699&bg=ffcc00
```

![Colored avatar](https://raw.githubusercontent.com/loopj/initials-avatar/master/examples/yo-50-yellow.png)

### Use as a Gravatar Fallback

Show the [Gravatar](http://gravatar.com) for a particular user, and fallback to showing their initials (*JD*) if the Gravatar doesn't exist:

```
http://www.gravatar.com/avatar/00000000000000000000000000000000?d=http%3A%2F%2Finitials.me%2FJD
```

## Dependencies

This app requires [ImageMagick](http://www.imagemagick.org/) and [Ghostscript](http://www.ghostscript.com/) to be installed:

### Mac

```shell
$ brew install imagemagick ghostscript
```

### Ubuntu

```shell
$ sudo apt-get install ruby-dev libmagickwand-dev imagemagick
```

## Installation

```shell
bundle install
```

## Starting the Server

### Rackup

For running locally, I recommend using the `rackup` command:

```shell
$ rackup
```

### Docker

You can run this in production using [Docker](https://docker.com) as follows:

```shell
$ docker pull loopj/initials-avatar
$ docker run -p 80:80 loopj/initials-avatar
```

### Mounting Under a Rails App

If you'd like to run this from inside an existing rails app, you can mount it as follows in `config/routes.rb`:

```ruby
match "/initials-avatar" => InitialsAvatar, :anchor => false
```

You can then access avatars at /initials-avatar/:initials from your rails app.

initials-avatar

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README