Self-hosted service for creating random avatars

Inspired by github default avatars

Default Port: 9000

Either download a release from the Releases page or clone the repo. Then follow the steps under Development Setup.

There is a container image available on Docker Hub and there is a Docker-Compose file in the repo.

See API Docs

• Node.js installation
• Libraries for image editing
• apiDoc installation, if editing docs

• Run brew install node or similar to install Node.js
• Run brew install pkg-config cairo pango libpng jpeg giflib librsvg or similar to install libraries for image editing
• Run npm install -g apidoc to install apiDoc globally

• Run npm start to start service
• Run npm run dev to start service with nodemon
• Run npm run generate:docs to generate API docs from source code

See CONTRIBUTING

See CREDITS

MIT (c) 2018 - 2024 frncsdrk and contributors