Maya-ACE
Maya-ACE: A Reference Client Implementation for NVIDIA ACE Audio2Face Service
File Explorer
Download Latest Version (.zip)- FindA2X_SDK.cmake
- FindAbsl.cmake
- FindAudiofile.cmake
- FindCares.cmake
- FindGrpc.cmake
- FindMaya.cmake
- FindOpenssl.cmake
- FindProtobuf.cmake
- FindPythonDeps.cmake
- FindRapidJson.cmake
- FindRe2.cmake
- FindTensorRT.cmake
- compiler_settings.cmake
- build-deps.packman.xml
- python-deps.pip.txt
- README.md
- requirements.txt
- target-deps.packman.xml
- attribute-network-info.png
- audiofile-menu-crop.png
- audiofile-menu.png
- bake-animation-dialog.png
- button-and-status-indicator.png
- button-send-audio.png
- button-update-time-slider.png
- change-timeslider-audio.png
- connect-jaw-transform.png
- connect-reye-rotation.png
- disable-audio2emotion.png
- disable-cached-playback.png
- disable-dag-only.png
- get-api-key.png
- huggingface-audio2face-3d-v3.png
- import-audio-menu.png
- import-audio.png
- mace-camila-v3.gif
- mace-dataflow-2-dark.png
- mace-dataflow-2-dark.svg
- mace-dataflow-2-light.png
- mace-dataflow-2-light.svg
- mace-overview-2-dark.png
- mace-overview-2-dark.svg
- mace-overview-2-light.png
- mace-overview-2-light.svg
- mace-play-both-a2f.gif
- mace-play-both.gif
- mace-play-james-a2f-bs.gif
- mace-play-james-a2f.gif
- mace-play-james.gif
- mace-play-mark.gif
- menu-attach-player-a2f-geom.png
- menu-attach-player-a2f.png
- menu-attach-player.png
- menu-connect-a2f-tongue.png
- menu-connection-editor.png
- node-editor-a2f-output.png
- open-attribute-editor.png
- partial-blendshape-1.png
- partial-blendshape-2.png
- plugin-manager.png
- reference-editor-james.png
- reference-editor.png
- samplescene-james-static.png
- samplescene-play.gif
- samplescene-static.png
- select-a2f-model-identity.png
- select-a2f-model.png
- select-a2fanimationplayer.png
- select-aceanimationplayer-set.png
- select-aceanimationplayer.png
- select-audio.png
- select-to-connect-a2f.png
- select-to-connect.png
- set-sample-project.png
- setup-connect-anim-player.png
- setup-connect-bottom-denture.png
- setup-connect-lower-face-done.png
- setup-connect-tongue.png
- standard-workflow.png
- timeline-preferences-60fps.png
- timeline-preferences.png
- timeslider-waveform.png
- ui-audio.png
- ui-bs-multipliers.png
- ui-bs-offsets.png
- ui-emotion-params.png
- ui-export-parameters.png
- ui-face-params.png
- ui-menu.png
- ui-models.png
- ui-service-and-request.png
- ui-service.png
- ui-status.png
- ui-statusbar-green.png
- ui-statusbar-grey.png
- ui-statusbar-yellow.png
- ui-tongue-parameters.png
- viewport-face-no-model.png
- window-import-james-v3.png
- window-trt-manager.png
- bestpractices.md
- buildandtest.md
- concepts.md
- prerequisites.md
- quickstart.md
- reallusionsample.md
- requirements.md
- setupinstructions.md
- troubleshooting.md
- userinterface.md
- nvidia_ace.a2f.v1.proto
- nvidia_ace.animation_data.v1.proto
- nvidia_ace.animation_id.v1.proto
- nvidia_ace.audio.v1.proto
- nvidia_ace.controller.v1.proto
- nvidia_ace.emotion_aggregate.v1.proto
- nvidia_ace.emotion_with_timecode.v1.proto
- nvidia_ace.services.a2f.v1.proto
- nvidia_ace.services.a2f_controller.v1.proto
- nvidia_ace.services.animation_controller.v1.proto
- nvidia_ace.services.animation_data.v1.proto
- nvidia_ace.status.v1.proto
- nvidia_ace-1.0.0-py3-none-any.whl
- files_to_compile.yaml
- generate_code_from_protos.py
- README.md
- requirements.txt
- setup.py
- ACE2Rig_Functions.py
- add-to-setup.py
- Batch_List_MayaDialog.py
- MH_Mapping.json
- README.md
- userSetup.mel
- Audio_Example1.wav
- Audio_Example2.wav
- Config_Example1.json
- Config_Example2.json
- Config_Example3.yaml
- batch_a2f.py
- batch_functions.py
- BatchList.json
- MH_Mapping.json
- README.md
- requirements.txt
- 01_Intro_What_is_This.jpg
- 01_Intro_What_is_This.mp4
- 02_Demo_MetaHuman.jpg
- 02_Demo_MetaHuman.mp4
- 03_Demo_Batch.jpg
- 03_Demo_Batch.mp4
- 04_How_to_Setup.jpg
- 04_How_to_Setup.mp4
- 05_Code_Overview_For_Customization.jpg
- 05_Code_Overview_For_Customization.mp4
- README.md
- abseil-LICENSE.txt
- audio2x-sdk-LICENSE.txt
- audiofile-LICENSE.txt
- benchmark-LICENSE.txt
- c-ares-LICENSE.md
- cnpy-LICENSE.txt
- cuda-LICENSE.txt
- cxxopts-LICENSE.txt
- eigen-LICENSE.APACHE
- eigen-LICENSE.BSD
- eigen-LICENSE.GPL
- eigen-LICENSE.LGPL
- eigen-LICENSE.MINPACK
- eigen-LICENSE.MPL2
- eigen-LICENSE.README
- GoogleTest-LICENSE.txt
- grpc-LICENSE.txt
- gtest-LICENSE.txt
- magic_enum-LICENSE.txt
- maya-ace-LICENSE.txt
- openssl-LICENSE.txt
- protobuf-LICENSE.txt
- pyyaml-LICENSE.txt
- rapidjson-license.txt
- re2-LICENSE.txt
- README.md
- refl-cpp-LICENSE.txt
- tbtsvd-LICENSE.txt
- TensorRT-Acknowledgements.txt
- TensorRT-Readme.txt
- zlib-LICENSE.txt
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- __init__.py
- v1_pb2.py
- v1_pb2_grpc.py
- __init__.py
- __init__.py
- health_pb2.py
- health_pb2_grpc.py
- version_pb2.py
- version_pb2_grpc.py
- mock_server.py
- pb2_all.py
- audio_1sec_16k_s16le.wav
- audio_4sec_16k_s16le.wav
- audio_6sec_48k_s16le.wav
- README.md
- claire_arkit_v2_topo1.ma
- james_arkit_v2.ma
- mark_arkit_v2_topo1.ma
- claire_arkit_v3.ma
- james_arkit_v3.ma
- mark_arkit_v3.ma
- claire_geom_v2_topo1.ma
- claire_geom_v3.ma
- james_geom_v3.ma
- mark_geom_v2_topo1.ma
- mark_geom_v3.ma
- README.md
- ace_v2_arkit.ma
- claire_v2_fullface.ma
- claire_v3_fullface.ma
- james_v3_fullface.ma
- mark_v2_fullface.ma
- mark_v3_fullface.ma
- chinese_voice_female_p01_neutral.wav
- english_voice_male_p1_neutral.wav
- README.md
- workspace.mel
- a2f_client_interface.h
- a2f_controller_client.cpp
- a2f_controller_client.h
- a2f_healthcheck_client.cpp
- a2f_healthcheck_client.h
- a2x_config_client.cpp
- a2x_config_client.h
- animation.cpp
- animation.h
- audio.cpp
- audio.h
- CMakeLists.txt
- frame_receiver.cpp
- frame_receiver.h
- grpc_client.cpp
- grpc_client.h
- logger.h
- parameters.cpp
- parameters.h
- status.h
- utility.cpp
- utility.h
- CMakeLists.txt
- health.grpc.pb.cc
- health.grpc.pb.h
- health.pb.cc
- health.pb.h
- health_mock.grpc.pb.h
- nvidia_ace.a2f.v1.grpc.pb.cc
- nvidia_ace.a2f.v1.grpc.pb.h
- nvidia_ace.a2f.v1.pb.cc
- nvidia_ace.a2f.v1.pb.h
- nvidia_ace.a2f.v1_mock.grpc.pb.h
- nvidia_ace.a2f_authoring.v1.grpc.pb.cc
- nvidia_ace.a2f_authoring.v1.grpc.pb.h
- nvidia_ace.a2f_authoring.v1.pb.cc
- nvidia_ace.a2f_authoring.v1.pb.h
- nvidia_ace.a2f_authoring.v1_mock.grpc.pb.h
- nvidia_ace.animation_data.v1.grpc.pb.cc
- nvidia_ace.animation_data.v1.grpc.pb.h
- nvidia_ace.animation_data.v1.pb.cc
- nvidia_ace.animation_data.v1.pb.h
- nvidia_ace.animation_data.v1_mock.grpc.pb.h
- nvidia_ace.animation_id.v1.grpc.pb.cc
- nvidia_ace.animation_id.v1.grpc.pb.h
- nvidia_ace.animation_id.v1.pb.cc
- nvidia_ace.animation_id.v1.pb.h
- nvidia_ace.animation_id.v1_mock.grpc.pb.h
- nvidia_ace.audio.v1.grpc.pb.cc
- nvidia_ace.audio.v1.grpc.pb.h
- nvidia_ace.audio.v1.pb.cc
- nvidia_ace.audio.v1.pb.h
- nvidia_ace.audio.v1_mock.grpc.pb.h
- nvidia_ace.controller.v1.grpc.pb.cc
- nvidia_ace.controller.v1.grpc.pb.h
- nvidia_ace.controller.v1.pb.cc
- nvidia_ace.controller.v1.pb.h
- nvidia_ace.controller.v1_mock.grpc.pb.h
- nvidia_ace.emotion_aggregate.v1.grpc.pb.cc
- nvidia_ace.emotion_aggregate.v1.grpc.pb.h
- nvidia_ace.emotion_aggregate.v1.pb.cc
- nvidia_ace.emotion_aggregate.v1.pb.h
- nvidia_ace.emotion_aggregate.v1_mock.grpc.pb.h
- nvidia_ace.emotion_with_timecode.v1.grpc.pb.cc
- nvidia_ace.emotion_with_timecode.v1.grpc.pb.h
- nvidia_ace.emotion_with_timecode.v1.pb.cc
- nvidia_ace.emotion_with_timecode.v1.pb.h
- nvidia_ace.emotion_with_timecode.v1_mock.grpc.pb.h
- nvidia_ace.services.a2f.v1.grpc.pb.cc
- nvidia_ace.services.a2f.v1.grpc.pb.h
- nvidia_ace.services.a2f.v1.pb.cc
- nvidia_ace.services.a2f.v1.pb.h
- nvidia_ace.services.a2f.v1_mock.grpc.pb.h
- nvidia_ace.services.a2f_authoring.v1.grpc.pb.cc
- nvidia_ace.services.a2f_authoring.v1.grpc.pb.h
- nvidia_ace.services.a2f_authoring.v1.pb.cc
- nvidia_ace.services.a2f_authoring.v1.pb.h
- nvidia_ace.services.a2f_authoring.v1_mock.grpc.pb.h
- nvidia_ace.services.a2f_controller.v1.grpc.pb.cc
- nvidia_ace.services.a2f_controller.v1.grpc.pb.h
- nvidia_ace.services.a2f_controller.v1.pb.cc
- nvidia_ace.services.a2f_controller.v1.pb.h
- nvidia_ace.services.a2f_controller.v1_mock.grpc.pb.h
- nvidia_ace.services.a2x_export_config.v1.grpc.pb.cc
- nvidia_ace.services.a2x_export_config.v1.grpc.pb.h
- nvidia_ace.services.a2x_export_config.v1.pb.cc
- nvidia_ace.services.a2x_export_config.v1.pb.h
- nvidia_ace.services.a2x_export_config.v1_mock.grpc.pb.h
- nvidia_ace.services.animation_controller.v1.grpc.pb.cc
- nvidia_ace.services.animation_controller.v1.grpc.pb.h
- nvidia_ace.services.animation_controller.v1.pb.cc
- nvidia_ace.services.animation_controller.v1.pb.h
- nvidia_ace.services.animation_controller.v1_mock.grpc.pb.h
- nvidia_ace.services.animation_data.v1.grpc.pb.cc
- nvidia_ace.services.animation_data.v1.grpc.pb.h
- nvidia_ace.services.animation_data.v1.pb.cc
- nvidia_ace.services.animation_data.v1.pb.h
- nvidia_ace.services.animation_data.v1_mock.grpc.pb.h
- nvidia_ace.status.v1.grpc.pb.cc
- nvidia_ace.status.v1.grpc.pb.h
- nvidia_ace.status.v1.pb.cc
- nvidia_ace.status.v1.pb.h
- nvidia_ace.status.v1_mock.grpc.pb.h
- README.md
- version.grpc.pb.cc
- version.grpc.pb.h
- version.pb.cc
- version.pb.h
- version_mock.grpc.pb.h
- export_service_config.cpp
- export_service_config.h
- request_sendaudio.cpp
- request_sendaudio.h
- a2x_data.h
- a2x_executors.h
- a2x_models.cpp
- a2x_models.h
- maya_utils.cpp
- maya_utils.h
- names.cpp
- names.h
- nvcloud.cpp
- nvcloud.h
- timeslider.cpp
- timeslider.h
- a2f_player.cpp
- a2f_player.h
- a2f_player_static.cpp
- a2x_ids.h
- a2x_plugin_data.h
- ace_player.cpp
- ace_player.h
- ace_player_static.cpp
- nvcf_ace_presets.json
- __init__.py
- ae_a2f_animation_player.py
- ae_a2f_shared.py
- ae_ace_animation_player.py
- arraycontrols.py
- audiocontrols.py
- buttoncontrols.py
- fieldcontrols.py
- fixed.py
- modelcontrols.py
- presetcontrol.py
- __init__.py
- config_export.py
- config_import.py
- qtutils.py
- service_export.py
- winutils.py
- __init__.py
- audio.py
- config.py
- misc.py
- names.py
- parameters.py
- preset.py
- setup.py
- utils.py
- green.svg
- grey.svg
- red.svg
- yellow.svg
- __init__.py
- __main__.py
- builder.py
- builder_ui.py
- models.py
- process_ui.py
- AEA2FAnimationPlayerTemplate.mel
- AEAceAnimationPlayerTemplate.mel
- trtgen.bat
- userSetup.mel
- config_ace_player_old.json
- config_nvcf13_james.json
- config_nvcf13_james.yaml
- simple_blendshape.ma
- test_ace_presets.json
- __init__.py
- common.py
- test_a2f_player.py
- test_ace_player.py
- test_audio.py
- test_commands.py
- test_config_export.py
- test_config_import.py
- test_config_old.py
- test_export_service.py
- test_plugin.py
- test_preset.py
- test_setup.py
- test_trt_builder.py
- test_trt_models.py
- test_utils.py
- CMakeLists.txt
- plugin.cpp
- profiler.cpp
- profiler.h
- CMakeLists.txt
- mace.mod.in
- README.md
- VERSION.md
- CMakeLists.txt
- main.cpp
- test_a2x_executor_data.cpp
- test_a2x_executors.cpp
- test_a2x_models.cpp
- test_constants.h
- CMakeLists.txt
- main.cpp
- test_a2f_controller_client.cpp
- test_a2f_health_check.cpp
- test_a2x_export_config.cpp
- test_animclient.cpp
- test_audio.cpp
- test_nvcf_client.cpp
- test_parameters.cpp
- test_utility.cpp
- utils.cpp
- utils.h
- CMakeLists.txt
- main.cpp
- test_maya_utils.cpp
- CMakeLists.txt
- configure.bat
- download_file_from_url.ps1
- fetch_file_from_packman_bootstrap.cmd
- generate_temp_file_name.ps1
- generate_temp_folder.ps1
- install_package.py
- config.packman.xml
- packman
- packman.cmd
- packmanconf.py
- python.bat
- python.sh
- test_with_coverage.py
- .clang-format
- .gitattributes
- .gitignore
- build.bat
- CHANGELOG.md
- CMakeLists.txt
- CONTRIBUTING.md
- download_models.bat
- env_maya.bat
- fetch_deps.bat
- LICENSE.txt
- README.md
- run_maya.bat
- run_mock_server.bat
- SECURITY.md
- test_a2x_local.bat
- test_ace_client.bat
- test_maya_plugin.bat
- test_maya_scripts.bat
- trtexec.bat
- trtgen.bat
# Installation Guide
1. Get the code
git clone https://github.com/NVIDIA/Maya-ACE
Downloads the entire project code from GitHub to your computer.
cd Maya-ACE
Moves into the project folder you just downloaded.
2. CMake
Medium RecommendedPrerequisites
mkdir build && cd build
Creates a folder to hold the build output and moves into it.
cmake ..
Analyzes the source code and generates build configuration files (must be run inside the build folder).
make
Compiles the code based on the generated build configuration to produce an executable.
Check that an executable was created inside the build folder, then run it directly (e.g. ./build/app_name).
3. Python
EasyPrerequisites
pip install -r deps/requirements.txt
Installs the Python libraries listed in requirements.txt (or similar).
python <μ€νν νμΌλͺ
>.py # READMEμμ μ νν μ€ν νμΌλͺ
μ νμΈνμΈμ
Runs the Python script (or module).
If it runs without errors and prints output in the terminal, it worked.
// repository documentation
Was this content helpful?
(0 ratings)
