CEB_ECON
CEB_ECON copied to clipboard
AI based all-in-one character generator Blender plug-in. This project contains unofficial updates for the CEB_ECON Blender add-on.
CEB_ECON Unofficial Update
This project contains unofficial updates for the CEB_ECON Blender add-on.
- ~~tuned ECON~~ Merged to official ECON
- tuned TEXTure
Installation Guide
Tutorial Video
- Tutorial video has been added
Download
-
Click on the green
<> Code
button and selectDownload ZIP
.- This will download the
CEB_ECON-main.zip
file.
- This will download the
-
Visit the original CEB_ECON page, name your fair price, and click on the 'purchase' button.
- If this project has been helpful to you, please consider supporting Carlos Barreto and CEB Studios on their Patreon page.
-
[RECOMMENDED] Download
CUDA 11.6
andvs_BuildTools.exe
.[NOT RECOMMENDED] Instead of installing
CUDA 11.6
andVS BuildTools
, you can downloadJIT_Compiler_PY38_CUDAv11.6.7z
from this link and install it from Blender.- You can skip this step if you have already installed CUDA 11.6 and Visual Studio 2019.
-
Obtain Hugging Face Tokens
- Register for a Hugging Face account and log in.
- Navigate to the https://huggingface.co/settings/tokens page.
- Create a new token.
- Click on the
New token
button. - Name it (e.g., ECON).
- Set the role to 'read'.
- Generate the token.
- Click on the
- Copy the token, paste it into
notepad
, and save the token text as a .txt file. Remove the .txt extension and name this fileTOKEN
.
Installation
-
vs_BuildTools.exe
- Open
vs_BuildTools.exe
. - Install the C++ build tools.
- Open
-
CUDA 11.6
- Install
CUDA 11.6
.
- Install
-
Run Blender as an administrator.
-
Navigate to the
Scripting
tab in Blender and copy-paste this code:import subprocess import sys subprocess.check_call([sys.executable, "-m", "pip", "install", "ruamel.yaml"])
-
Press the
Enter
key and ensure that it returns 0:>>> import subprocess >>> import sys >>> subprocess.check_call([sys.executable, "-m", "pip", "install", "ruamel.yaml"]) 0
-
Navigate to
Edit
->Preferences
->Add-ons
. Click on theInstall
button and select theCEB_ECON-main.zip
file. Then, click onInstall Add-on
. -
Enable the CEB_ECON add-on by clicking on
General: CEB ECON
. Close the Preferences window. -
Navigate to
Window
->Toggle System Console
and keep this window open for reference.- From this point forward, keep an eye on this window for any potential errors as you proceed with the installation process.
-
Open the
ECON Install
tab in Blender.- Click on the arrow button on the right side.
- Click on
ECON Install
to open the installation tab.
-
Click on
Venv and Installs
to open the tab. -
Click on
Path
and choose the directory in which to install the virtual environment (venv).- For example, C:\ECON_VENV
-
Click on
Create ECON Venv
and wait for the process to complete. -
Click on
Download ECON
and wait for the download to complete. -
Click on
Finish ECON Install
and wait for the installation to finish. -
Click on
Down&Install Pytorch_3D
and wait for the process to complete. -
Click on
Download TEXTure
and wait for the download to complete. -
Click on the
Register
button, then go toLogin
->Register
to register. -
Log in.
-
Click on the
Register on all
button from the Blender add-on. -
Register all projects by clicking on the
Register now
buttons. -
Go back to Blender, type your ID and password, then click
Download
.-
This may take some time. Wait until the process is finished. (if you see
Out: pymafx_data.zip
on the console window, it means the process is finished.) - This add-on does not collect your ID and password data.
-
This may take some time. Wait until the process is finished. (if you see
-
If desired, you can delete downloaded zip files by checking
Erase Zip
and clicking on theDownload
button once more. -
Copy the
TOKEN
file toC:\Users\{USER NAME}\AppData\Roaming\Blender Foundation\Blender\{BLENDER VERSION}\scripts\addons\CEB_ECON-main\ECON\TEXTure\
.
Test Run
Blender requires administrative privileges for the first run.
-
Navigate to the
ECON Generate Models
tab on the right side to generate 3D models. -
[Optional] You can change the
ECON Settings
and click on
Save Configuration
.- Refer to this page to understand how each option affects the output.
-
Import a full-body image by clicking on
Import Image
. -
Click on
Generate 3D Model
to generate a 3D model from the provided image.- Per vertex color is included. You can check it by navigating to
Material Properties
->New
->Base Color
(click circle button) ->Input
->Color Attribute
.
- Per vertex color is included. You can check it by navigating to
-
Click on
Generate Animatable 3D Model
to generate a model in A pose with a UV mapped texture file. -
To generate a backside texture, write a prompt that describes your image and click on Generate texture.
- For example, A man wearing a black T-shirt, black jeans, and black shoes.
-
After the first run, Blender no longer requires administrative privileges.
Release Notes
-
June 1, 2023:
- Uploaded Tutorial video
-
May 26, 2023:
- Fix TEXTure install bug
- Fix IFNet option
-
May 25, 2023:
- Fix imperfect texturing (TEXTure)
-
May 24, 2023:
- Updated the TEXTure Feature
- Updated the Avatarizer Feature
- UI Improvements
-
May 23, 2023:
- Updated the "Download ECON" button to fetch the newer version of ECON, moving from the Jan 09 version to the May 14 version.
- Enabled config (econ.yaml) modifications directly from the add-on. For usage instructions, refer to the tricks.md. Please note there is a current issue with 'use_ifnet' that needs fixing.
Upcoming Updates
For the Plugin
- Integration with Mixamo.
- ~~Integration with the TEXTure feature is underway, which will include both the installation and usage aspects.~~ (done)
For ECON
- ~~Working to resolve the xatlas UV mapping issue that causes black seams.~~ (done)
- ~~Improvement of the Texture feature.~~ (done)
- Plans to enable Unity integration are in the pipeline.
- ~~The 'use_ifnet' bug fix is currently being worked on.~~ (done)
- ~~Directory bug on windows~~ (temp fix on CEB ECON)
Tested Environment
The plugin has been tested and validated under the following hardware and software configurations:
- OS: Windows 11 (Please note, only Windows OS is currently supported)
- CPU: Intel i7 13700K
- GPU: NVIDIA RTX 4080 with 16GB VRAM
- RAM: 32GB
performance may vary under different hardware configurations