🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more
Socket
DemoInstallSign in
Socket

github.com/go-universal/avatar

Package Overview
Dependencies
Alerts
File Explorer
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

github.com/go-universal/avatar

v0.0.2
Source
Go
Version published
Created
Source

Avatar

GitHub Tag Go Reference License Go Report Card Contributors Issues

avatar is a Go library for generating customizable avatars. It supports creating avatars for text, stickers, and persons with various customization options.

LetterStickerMaleFemale
LetterStickerMaleFemale

Installation

To install Avatar, use go get:

go get github.com/go-universal/avatar

Usage

Creating a Text Avatar

package main

import (
    "github.com/go-universal/avatar"
    "log"
)

func main() {
    factory := avatar.
        New().
        DefaultPalettes().
        CircleShape().
        Build()

    johnDoe := factory.NewText("John Doe", "")

    johnDoe.
        RandomizeShape().
        RandomizePalette()

    err := johnDoe.SaveAs("john_doe.svg")
    if err != nil {
        log.Fatal(err)
    }
}

Creating a Sticker Avatar

package main

import (
    "github.com/go-universal/avatar"
    "log"
)

func main() {
    factory := avatar.
        New().
        DefaultPalettes().
        CircleShape().
        Build()

    star := factory.NewSticker("", "")

    star.
        RandomizeShape().
        RandomizePalette()

    err := star.SaveAs("star.svg")
    if err != nil {
        log.Fatal(err)
    }
}

Creating a Person Avatar

package main

import (
    "github.com/go-universal/avatar"
    "log"
)

func main() {
    factory := avatar.
        New().
        DefaultAccessories().
        DefaultBeards().
        SuitDress().
        PrescriptionGlasses().
        DarkHairColor().
        DefaultHairs().
        DefaultPalettes().
        CircleShape().
        WhiteSkin().
        Build()

    male := factory.NewMale("")
    male.
        RandomizeShape().
        RandomizePalette().
        RandomizeSkinColor().
        RandomizeHairColor().
        RandomizeHair().
        RandomizeBeard().
        RandomizeDress().
        RandomizeEye().
        RandomizeEyebrow().
        RandomizeMouth().
        RandomizeGlasses().
        RandomizeAccessory()
    err := male.SaveAs("male.svg")
    if err != nil {
        log.Fatal(err)
    }

    female := factory.NewFemale("")
    female.
        RandomizeShape().
        RandomizePalette().
        RandomizeSkinColor().
        RandomizeHairColor().
        RandomizeHair().
        RandomizeBeard().
        RandomizeDress().
        RandomizeEye().
        RandomizeEyebrow().
        RandomizeMouth().
        RandomizeGlasses().
        RandomizeAccessory()
    err := female.SaveAs("female.svg")
    if err != nil {
        log.Fatal(err)
    }
}

Extending

Avatar generation in this package is based on modular SVG elements. You can easily customize the existing avatar styles or add new ones using the provided helper methods.

To create or modify styles:

  • Start by editing the template.ai file.
  • Save your design as an SVG.
  • Extract the relevant parts (e.g., shapes, hair, accessories) and integrate them into the avatar package.

Each SVG shape must include placeholders to enable dynamic replacement of colors in the final rendering.

Template Variables for Custom Palettes

Use the following template variables in your SVG elements to enable dynamic styling:

  • {shape} — Background shape color
  • {skin} — Base skin tone
  • {skin_shadow} — Shadowed areas of the skin
  • {hair} — Hair color
  • {hair_shadow} — Shadowed areas of the hair
  • {hair_highlight} — Highlighted areas of the hair
  • {dress} — Clothing color
  • {dress_shadow} — Shadowed areas of the clothing
  • {decorator} — Accessories (e.g., glasses, necklace)
  • {text} — Text and sticker color

These variables allow your avatar elements to adapt to different themes and palettes dynamically.

License

This project is licensed under the ISC License. See the LICENSE file for details.

FAQs

Package last updated on 28 Apr 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts