o1egl
govatar
Go

Avatar generation library for GO language

Last updated May 22, 2026
608
Stars
49
Forks
1
Issues
0
Stars/day
Attention Score
26
Language breakdown
No language data available.
Files click to expand
README

GOvatar

License GoDoc Build Coverage Go Report Card

GOvatar image

GOvatar is an avatar generation library written in GO


Notes

  • From release v0.4.0 onward, the minimal supported golang version is 1.16.

Install

Brew

$ brew tap o1egl/tap
$ brew install govatar

Docker

$ docker pull o1egl/govatar

From source

$ go get -u github.com/o1egl/govatar/...

Prebuilt binary packages are available for Mac, Linux, and Windows.

Usage

$ govatar generate male -o avatar.png                        # Generates random avatar.png for male
$ govatar generate female -o avatar.png                      # Generates random avatar.png for female
$ govatar generate male -u username@site.com -o avatar.png   # Generates avatar.png for specified username
$ govatar -h                                                 # Display help message

As lib

Generates avatar and save it to filePath

err := govatar.GenerateFile(govatar.MALE, "/path/to/avatar.jpg")
err := govatar.GenerateFileForUsername(govatar.MALE, "username", "/path/to/avatar.jpg")

Generates an avatar and returns it as an image.Image

<pre><code class="lang-go">img, err := govatar.Generate(govatar.MALE) img, err := govatar.GenerateForUsername(govatar.MALE, &quot;username&quot;)</code></pre>

Copyright, License & Contributors

Adding new skins

  • Add new skins to the background, male/clothes, female/hair, etc...
  • Submit pull request :)

Submitting a Pull Request

  • Fork it.
  • Create a branch (git checkout -b my_branch)
  • Commit your changes (git commit -am "Added new awesome avatars")
  • Push to the branch (git push origin my_branch)
  • Open a Pull Request
  • Enjoy a refreshing Diet Coke and wait
GOvatar is released under the MIT license. See LICENSE
🔗 More in this category

© 2026 GitRepoTrend · o1egl/govatar · Updated daily from GitHub