Package: mcme
MCME - Meshcapade Me Command Line ClientWelcome to the age of Avatars, introducing the Meshcapade Me CLI (MCME). Create accurate digital doubles from any source of data in a unified 3D body format for every industry.
Built on ourpatented avatar technology, MCME simplifies the avatar creation process, allowing you to create and download avatars directly from your terminal. This interface is ideal for users who favor terminal-based interactions or seek seamless integration of avatar creation into automated processes. If you prefer alternative methods, we've got you covered with anAPIand aWeb UIfor creating, editing, and downloading avatars.InstallationMCME requiresPython 3.9+To ensure a clean and isolated installation, we recommend using a virtual environment (venv). Here's an example of how to set up MCME within a virtual environment:# Create a virtual environmentpython3.10-mvenvmcme_env# Activate the virtual environmentsourcemcme_env/bin/activate# On Windows, use `mcme_env\Scripts\activate`# Install MCMEpipinstallmcmeUsageTo make sure the installation worked and to view the general help, execute the following command:mcme--helpAuthenticationTo authenticate with MCME, use yourmehscapade.mecredentials. If you haven't registered yet, take a moment to sign up for a free account. For now, when setting up for CLI access, please register using a username and password. Single Sign-On (SSO) support is on its way and will be available soon!When you execute mcme for the first time or after your access token has expired, you will be prompted for username and password. Alternatively you can set them using:mcme--username<your_username>--password<your_password>Or save them as environment variables:exportMCME_USERNAME=<your_username>exportMCME_PASSWORD=<your_password>CreditsPlease be aware that creating avatars consumes credits, provided the creation is successful. Creating an avatar from betas, measurements or images costs100 credits, creating one from scans or videos costs500 credits. You can check your current credit balance at any time by using the following command:mcmeuser-infoIf you find yourself running low on credits or wish to purchase more, visit ourcredits page.Avatar CreationGenerate unique avatars effortlessly with themcme createcommand. To explore the available methods and options, use:mcmecreate--helpHere's an example command:Using this command to successfully create an avatar from images incurs a charge of 100 credits.mcmecreatefrom-images--genderFEMALE--namemy_cli_avatar--input/path/to/image.jpg--height165--weight60--image-modeAFICustomize the avatar creation with the following options:--gender [MALE|FEMALE|NEUTRAL]: Specify the gender of the created avatar.--name TEXT: Assign a name to the created avatar.--input FILE: Provide the path to the input image.--height INTEGER: Specify the height of the person in - the image.--weight INTEGER: Specify the weight of the person in - the image.--image-mode [AFI|BEDLAM_CLIFF]: Choose the mode for avatar creation.Avatar Creation with Immediate DownloadIf you want to download the avatar immediately after creation, you can include download options by appending them after thecreatecommand:Using this command to successfully create an avatar from images incurs a charge of 100 credits.mcmecreate--download-formatobj--poseT--compatibility-modeDEFAULT--out-file/path/to/output/file.objfrom-images...This command allows you to specify various download options:--download-format [OBJ|FBX]: Choose the format for - downloading the avatar, either OBJ or FBX.--pose [T|A|I|SCAN]: Select the desired pose for the - downloaded avatar. Note that SCAN is only applicable for - avatars created from images, as it corresponds to the - pose of the person captured in the image.--compatibility-mode [DEFAULT|OPTITEX|UNREAL]: Adjust - output for compatibility with selected software.--out-file FILE: Specify a file to save the created avatar mesh to.Avatar DownloadTo download avatars created using MCME, the API, or the Web UI associated with your account, use themcme downloadcommand. Customize the download with the options shown inAvatar Creation with Immediate Downloador explore them using:mcmedownload--helpExecuting the download command initiates an export job, and after a brief processing time, your avatar will be downloaded to the current working directory.If you choose not to specify the asset ID directly, the command lists the last ten avatars you created, allowing you to choose which one to download. Use the option--show-max-avatarsto list more than ten avatars.