avatar-generator

组合特征一键生成卡通头像组件

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 数字人3D 🍴 复刻 121 🐛 待处理 6 👀 关注 14
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1312
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

avatar-generator 项目界面预览图
图片来源:项目官网

项目数据

分类数字人3D
开发团队draftbit
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议MIT
主要语言JavaScript
技术栈/模型avatars,personas,reasonml
GitHub 星标★ 1312
上线时间2018-10-08 00:00:00
代码更新2026-10-23
仓库体积1.7 MB
本站数据更新2026-10-28
维护状态活跃
收录时间2026-10-28
浏览次数0

项目介绍

avatar-generator 是 Draftbit 开源的虚拟形象生成器,项目代号 Personas,用 ReasonML 编写并编译为 JavaScript。它面向需要为用户生成个性化头像的应用场景,解决手动设计头像成本高、风格不统一的问题。核心能力是根据用户特征组合出可配置的卡通人物形象,包括脸型、发型、肤色、五官、服饰等可选项,输出可复用的矢量或组件化头像。项目提供 React Native 组件形态,便于在移动端直接渲染,也适合在 Web 端通过构建流程接入。整体定位是轻量、可定制的头像生成方案,适合社交、社区、游戏化产品快速补齐用户头像能力,无需依赖外部头像服务。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-28 · 当前星标 ★ 1312

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • Node 22 及以上版本(版本要求见仓库 .nvmrc)
  • Yarn 4,通过 corepack enable 启用
  • 需要同时运行 ReScript 编译和 Vite 开发服务器,建议准备两个终端窗口

安装与启动步骤

  1. 1获取项目代码

    克隆 Draftbit 的 avatar-generator 仓库到本地,然后进入项目目录。

    git clone https://github.com/draftbit/avatar-generator.git
    cd avatar-generator
  2. 2启用 Yarn 4

    项目使用 Yarn 4 管理依赖,先用 corepack 启用对应版本。

    corepack enable
  3. 3安装依赖

    在项目根目录执行 yarn,安装 ReScript、React 18、Vite 等全部依赖。

    yarn
  4. 4启动编译监听

    在第一个终端中运行,ReScript 源码改动会实时编译为 JavaScript。

    yarn re:watch
  5. 5启动开发服务器

    另开一个终端运行 Vite 开发服务器,与上一步的编译监听同时保持运行。

    yarn dev
  6. 6构建与本地预览

    需要产出生产版本时执行 build,产物在 dist/ 目录,可用 preview 本地查看。

    yarn build
    yarn preview

关键配置

配置项必填说明示例
CLOUDFLARE_API_TOKEN否仅自动部署到 Cloudflare Workers 时需要,配置在仓库 Secrets 中your-cloudflare-api-token
CLOUDFLARE_ACCOUNT_ID否仅自动部署时需要,用于指定 Cloudflare 账号your-cloudflare-account-id

如何确认成功

保持 yarn re:watch 运行,打开 yarn dev 输出的本地地址,能看到头像生成页面并可切换发型、眼睛等选项。

常见问题

Q:只跑 yarn dev 页面却是空白或报错?

A:因为项目用 ReScript 编写,必须先运行 yarn re:watch 持续编译,再同时运行 yarn dev,两者缺一不可。

Q:提示 Node 或 Yarn 版本不符怎么办?

A:按仓库 .nvmrc 切换到 Node 22+,并先执行 corepack enable 启用 Yarn 4 后再安装依赖。

Q:如何部署到线上?

A:推送到 master 分支会通过 GitHub Actions 自动部署到 Cloudflare Workers,前提是仓库已配置 CLOUDFLARE_API_TOKEN 与 CLOUDFLARE_ACCOUNT_ID;本地也可执行 yarn deploy。

Q:想直接分享某个头像样式?

A:可用 URL 参数指定样式与色值,例如 ?hair=Mohawk&hairColor=F2C94C&eyes=Hearts,可用选项可通过 /api/options 获取。

注意事项

  • 克隆后务必进入项目目录再执行 yarn,否则找不到 package.json。
  • 开发时要保持 re:watch 与 dev 两个进程同时运行。
  • 生产构建产物输出在 dist/ 目录。
  • 仅本地开发无需配置 Cloudflare 相关的两个密钥。

核心亮点

  • 提供 React Native 组件形态,移动端可直接渲染使用
  • 头像特征维度丰富,支持脸型、发型、肤色、服饰等组合
  • 基于 ReasonML 编写,类型安全,组件结构清晰易维护

不足之处

  • 社区规模较小,文档和示例相对有限
  • 自定义扩展需要理解 ReasonML 构建流程,上手门槛偏高

适用场景

  • 社交或社区应用为新用户生成默认头像
  • 游戏化产品为玩家创建个性化卡通形象
  • 多租户 SaaS 平台统一用户头像风格

替代项目

dicebear、avataaars、boring-avatars

上一篇:OmniX

下一篇:ai-live-avatar

同类项目推荐

easi-tex 开源

单张图秒变 3D 纹理,边缘细节不糊掉

[SIGGRAPH 2024] "EASI-Tex: Edge-Aware Mesh Texturing from Single Image", ACM Transac···

★ 128 2026-08-09
ditto-talkinghead 开源

音频驱动实时说话头像,运动空间扩散精准可控

[ACM MM 2025] Ditto: Motion-Space Diffusion for Controllable Realtime Talking Head S···

★ 924 2026-08-09
MVControl 开源

用文本精准控制3D生成,几何细节更真实

[3DV-2025] Official implementation of "Controllable Text-to-3D Generation via Surfac···

★ 216 2026-08-09
ai-waifu 开源

打造你的二次元 AI 伴侣,能聊能听会变脸

AI VTuber Waifu and voice assistant

★ 151 2026-08-09
TaoMate 开源

一段音频,实时生成不崩脸的长视频数字人

a real-time digital-human model for long-form audio-video generation

★ 510 2026-09-13
ScaleDreamer 开源

用文本快速生成高质量 3D 模型,省显存又高效

[ECCV2024] ScaleDreamer: Scalable Text-to-3D Synthesis with Asynchronous Score Disti···

★ 54 2026-08-09
AlphaAvatar 开源

像搭积木一样拼出能听会说有记忆的实时数字人

An Omni Real-Time Assistant for Everyone

★ 819 2026-09-16
GVGEN 开源

输入文字,一键生成3D数字人模型

[ECCV 2024] GVGEN: Text-to-3D Generation with Volumetric Representation

★ 119 2026-08-09
CityDreamer4D 开源

从单图生成无限动态 4D 城市,用于仿真与创作

The official implementation of "Compositional Generative Model of Unbounded 4D Citie···

★ 152 2026-08-09