一个Python Web API,利用无头Blender和MPFB2插件从人脸图像程序化生成3D身体和匹配服装,并完全容器化运行。

Stars

3

7 天增长

暂无数据

Fork 数

0

开放 Issue

0

开源协议

CC0-1.0

最近更新

2026-07-29

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它为实现数字永生和AI克隆提供了实用基础,能够从一张照片自动生成可定制的3D人体数字容器。

适合谁使用

  • 构建化身或数字身份系统的开发者
  • 需要程序化人体生成的3D艺术家
  • VR/AR应用创作者
  • 数字复活与AI克隆领域的研究人员

典型使用场景

  • 为游戏或虚拟世界生成个性化3D化身
  • 为电子商务试穿生成合身的虚拟服装
  • 创建用于纪念或数字永生平台的数字形象
  • 为动画或模拟快速生成人体模型原型

项目优势

  • 完全通过Docker容器化,无需本地安装Blender或Python
  • 使用MPFB2从人脸图像生成真实、参数化的身体
  • 服装匹配结果被缓存,后续请求几乎即时返回
  • 采用CC0公共领域许可证,允许无限制使用

使用前须知

  • 需要Docker和Linux主机环境
  • 依赖MPFB2插件,该插件可能有自身的限制
  • 服装选项有限(仅展示一个示例)
  • 不适合实时生成(使用无头Blender处理)

README 快速开始

Yvonta - Body Factory

Your next life begins with an upload.

This application is a Python-based web API designed to procedurally generate 3D bodies and avatars. It leverages a headless instance of Blender in combination with the MPFB2 (MakeHuman Plugin for Blender) plugin to construct these assets, with the entire pipeline containerized within Docker for seamless deployment.


How to install?

Since the application is fully containerized, you do not need to install Blender or Python locally. Ensure you have Docker and Docker Compose installed on your system (e.g., Debian, Ubuntu, or your preferred Linux distribution).

  1. Clone the repository:
   git clone [https://github.com/Yvonta/body-factory.git](https://github.com/Yvonta/body-factory.git)
   cd body-factory

  1. Build the Docker container: This step pulls the base image, installs Python dependencies, downloads Blender, and configures the MPFB2 plugin.
docker build -t yvonta-body-factory .

  1. Run the application:
docker run -d -p 8090:8090 --name body-factory yvonta-body-factory

The API will now be accessible at http://localhost:8090.


How to use?

The application exposes a RESTful web API that generates .glb 3D models from face images and applies fitted clothing to the generated avatars.

1. Generate an Avatar

Submit a face image alongside macro parameters (gender, age, weight) to generate the base body. The API returns the 3D .glb file and provides a unique X-Avatar-Id in the response headers for future modifications.

curl -sS -D headers.txt -o avatar.glb \
    -F "gender=0.0" \
    -F "age=0.4" \
    -F "weight=0.5" \
    -F "file=@path/to/face.jpg" \
    "http://localhost:8090/v1/avatar/generate"

Check headers.txt for your X-Avatar-Id.

2. Fit Clothing to the Avatar

Using the X-Avatar-Id returned in step 1, you can request specific garments. The API runs a headless Blender process to fit the clothing to your exact avatar's proportions and caches the result for near-instant subsequent requests.

curl -sS -o clothing_1.glb \
    "http://localhost:8090/v1/avatar//clothing/toigo_basic_tucked_t-shirt"

*Tip: You can load both avatar.glb and clothing_1.glb together into a viewer like glTF Viewer to verify that the garment lines up

项目描述

Your next life begins with an upload

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390
slvDev
精选
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型
1,960
littledivy
精选
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI 与机器学习
1,482