项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-28 · 当前星标 ★ 1312
使用教程
环境要求
- Node 22 及以上版本(版本要求见仓库 .nvmrc)
- Yarn 4,通过 corepack enable 启用
- 需要同时运行 ReScript 编译和 Vite 开发服务器,建议准备两个终端窗口
安装与启动步骤
-
1获取项目代码
克隆 Draftbit 的 avatar-generator 仓库到本地,然后进入项目目录。
git clone https://github.com/draftbit/avatar-generator.git cd avatar-generator -
2启用 Yarn 4
项目使用 Yarn 4 管理依赖,先用 corepack 启用对应版本。
corepack enable -
3安装依赖
在项目根目录执行 yarn,安装 ReScript、React 18、Vite 等全部依赖。
yarn -
4启动编译监听
在第一个终端中运行,ReScript 源码改动会实时编译为 JavaScript。
yarn re:watch -
5启动开发服务器
另开一个终端运行 Vite 开发服务器,与上一步的编译监听同时保持运行。
yarn dev -
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···
ditto-talkinghead
开源
音频驱动实时说话头像,运动空间扩散精准可控
[ACM MM 2025] Ditto: Motion-Space Diffusion for Controllable Realtime Talking Head S···
MVControl
开源
用文本精准控制3D生成,几何细节更真实
[3DV-2025] Official implementation of "Controllable Text-to-3D Generation via Surfac···
ai-waifu
开源
打造你的二次元 AI 伴侣,能聊能听会变脸
AI VTuber Waifu and voice assistant
TaoMate
开源
一段音频,实时生成不崩脸的长视频数字人
a real-time digital-human model for long-form audio-video generation
ScaleDreamer
开源
用文本快速生成高质量 3D 模型,省显存又高效
[ECCV2024] ScaleDreamer: Scalable Text-to-3D Synthesis with Asynchronous Score Disti···
像搭积木一样拼出能听会说有记忆的实时数字人
An Omni Real-Time Assistant for Everyone
GVGEN
开源
输入文字,一键生成3D数字人模型
[ECCV 2024] GVGEN: Text-to-3D Generation with Volumetric Representation
CityDreamer4D
开源
从单图生成无限动态 4D 城市,用于仿真与创作
The official implementation of "Compositional Generative Model of Unbounded 4D Citie···