mana-am/humation-swift

Humation Swift is a library for Apple platforms that generates cartoon-style avatars from a seed value. A seed is any piece of data you pass in, like a user ID or a username, and the library always produces the same avatar from the same seed. This means users get a consistent avatar that belongs to their account, similar to how some platforms generate default profile images automatically. The avatars are built from hand-drawn illustrated parts, covering heads, bodies, clothes, and accessories, with six customizable color slots: background, stroke, hair, skin, clothes, and bottom. You can supply custom colors to match your app's style, or let the seed determine everything automatically. A notable design choice is that all rendering happens natively using Apple's Core Graphics framework. The library does not load a browser window and makes no network requests, which keeps it fast and suitable for production use in iOS and macOS apps. The same seed produces the same avatar on both native Swift and the original web-based version of the library, so avatars stay consistent if you use both platforms. The library ships with 86 pre-built avatar parts bundled inside the package, so no separate asset download is needed. Setup is a single Swift Package Manager line. Common cases are covered by simple one-liners, like getting a UIImage from a user ID. Lower-level types give full control over part selection and colors. A SwiftUI component is included for easy display. The library supports iOS 15 and later, macOS 12 and later, tvOS, and visionOS. It is a Swift port of an open-source library originally written for web apps, and the two produce identical output from the same seed. The license is MIT.