This project contains unofficial updates for the CEB_ECON Blender add-on.
tuned ECONMerged to official ECON- tuned TEXTure
- Tutorial video has been added
-
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
.
-
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\
.
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.
-
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.
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)
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