Preparation ⚙️

Word count

1006 words

Reading time

7 minutes

• Third-party Account Registration and Environment Variable Configuration
• Required Software Installation

Account Registration

Register as needed based on your use case.

Name	Environment Variable	Use Case	VPN Required	Recommendation
OpenAi	OPENAI_API_KEY	Translation	✅	🔥🔥🔥🔥🔥
Gemini	GOOGLE_API_KEY	Translation	✅	🔥🔥🔥🔥🔥
DashScope	DASHSCOPE_API_KEY	Translation	❌	🔥🔥🔥🔥
Huggingface	HUGGINGFACEHUB_API_TOKEN	Multi-Speaker	✅	🔥🔥🔥🔥🔥
Ngrok	NGROK_AUTH_TOKEN	Tunneling	✅	🔥🔥🔥🔥🔥

Note

• OpenAi is a paid service and does not offer free credits.
• Gemini provides free credits sufficient for daily use.
• DashScope offers 1 million free tokens for new users, typically valid for 30 to 180 days.
• Ngrok is optional and not required for local deployment.

Environment Variables

Windows, Linux, MacOS

Below are the environment variables and corresponding API keys that need to be configured. Replace <OPENAI_API_KEY>, <GOOGLE_API_KEY>, <DASHSCOPE_API_KEY>, <HUGGINGFACEHUB_API_TOKEN> and <NGROK_AUTH_TOKEN> with your actual keys.

All information is stored locally on your computer as environment variables. The program does not record or save API key information.

1. Right-click This PC and select Properties.

2. Click Advanced system settings, then choose Environment Variables.

3. Under the System variables section, click New and add the following variables:

• OPENAI_API_KEY
• GOOGLE_API_KEY
• DASHSCOPE_API_KEY
• HUGGINGFACEHUB_API_TOKEN
• NGROK_AUTH_TOKEN

4. Open Command Prompt or PowerShell and run the following command to verify:

echo $env:GOOGLE_API_KEY

Tip

For Colab usage, see the 《Remote Deployment》 section.

Required Software

Multimedia Processing: FFmpeg

FFmpeg is a powerful, cross-platform, open-source command-line tool and development library for processing audio and video files. It can be used for recording, converting, editing, and streaming audio and video, supporting almost all common formats.

1. Download and Install

Download the FFmpeg installation package from the official website based on your operating system: https://ffmpeg.org

For example, on Windows:

• Extract the ffmpeg-essentials_build.7z archive to the D:\Program Files\FFmpeg folder.
• Add D:\Program Files\FFmpeg\bin to the Path environment variable and log out and back in.

2. Verify Installation

Open PowerShell and enter the following command:

ffmpeg -version

Successful installation returns:

ffmpeg version 2025-06-04-git-a4c1a5b084-essentials_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers
built with gcc 15.1.0 (Rev4, Built by MSYS2 project)
configuration: --enable-gpl --enable-version3 --enable-static --disable-w32threads --disable-autodetect --enable-fontconfig --enable-iconv --enable-gnutls --enable-libxml2 --enable-gmp --enable-bzlib --enable-lzma --enable-zlib --enable-libsrt --enable-libssh --enable-libzmq --enable-avisynth --enable-sdl2 --enable-libwebp --enable-libx264 --enable-libx265 --enable-libxvid --enable-libaom --enable-libopenjpeg --enable-libvpx --enable-mediafoundation --enable-libass --enable-libfreetype --enable-libfribidi --enable-libharfbuzz --enable-libvidstab --enable-libvmaf --enable-libzimg --enable-amf --enable-cuda-llvm --enable-cuvid --enable-dxva2 --enable-d3d11va --enable-d3d12va --enable-ffnvcodec --enable-libvpl --enable-nvdec --enable-nvenc --enable-vaapi --enable-openal --enable-libgme --enable-libopenmpt --enable-libopencore-amrwb --enable-libmp3lame --enable-libtheora --enable-libvo-amrwbenc --enable-libgsm --enable-libopencore-amrnb --enable-libopus --enable-libspeex --enable-libvorbis --enable-librubberband
libavutil      60.  3.100 / 60.  3.100
libavcodec     62.  3.101 / 62.  3.101
libavformat    62.  0.102 / 62.  0.102
libavdevice    62.  0.100 / 62.  0.100
libavfilter    11.  0.100 / 11.  0.100
libswscale      9.  0.100 /  9.  0.100
libswresample   6.  0.100 /  6.  0.100

Recommended Downloads

Virtual Environment: Miniconda

Miniconda is a lightweight tool for quickly creating clean, isolated Python virtual environments, suitable for data analysis, AI projects, custom scripts, etc.

1. Download and Install

Download the Miniconda installation package from the official website based on your operating system: https://www.anaconda.com/download/success

For example, on Windows:

• Double-click the .exe installer.
• Check “Add Miniconda to PATH” (optional but recommended).
• After installation, search for "Anaconda Prompt" in the Start menu.

2. Verify Installation

# List all virtual environments
conda env list

Successful installation returns:

PS C:\Users\home> conda env list
# conda environments:
#
base                   D:\Projects\miniconda3

3. Common Commands

Command	Description
conda create --name creatorbox python=3.11.11	Create a virtual environment named creatorbox with Python version 3.11.11.
conda env list	List all created virtual environments.
conda activate creatorbox	Activate the creatorbox environment.
conda deactivate	Exit the currently activated environment.
conda remove -n creatorbox --all	Delete the entire creatorbox environment.

Note

Miniconda is recommended over Anaconda for its smaller size, faster startup, and cleaner dependencies.

Version Control: Git

Git is a distributed version control system that helps developers track code changes, collaborate with others, and efficiently manage software projects.

1. Download and Install

Download the Git installation package from the official website based on your operating system: https://git-scm.com

For example, on Windows:

• Double-click the .exe installer.
• It is recommended to keep the default options during installation.

2. Verify Installation

Right-click on the desktop, select Git Bash Here, and enter the following command:

git --version

Successful installation returns:

git version 2.47.0.windows.2

3. Common Commands

Command	Description
git clone <repository_url>	Clone and download files from the repository URL.
git fetch --all	Fetch updates from all remote repositories without automatically merging into the local branch.
git checkout 50d1269	Switch to the corresponding commit 50d1269.
git checkout tags/1.0.19	Switch to the corresponding tag tags/1.0.19.
git reset --hard origin/master	Force reset the current branch to the latest commit of the remote origin/master.
git pull	Pull the latest changes.

Note

• Command operations need to be performed in the folder where CreatorBox was downloaded.
• It is best to avoid spaces or Chinese characters in the path to prevent potential issues.

Video Editing: Capcut

Capcut is an all-in-one, user-friendly desktop video editing software that simplifies content creation.

1. Download and Install

Download the JianYing installation package from the official website based on your operating system: https://www.capcut.cn

For example, on Windows:

• Double-click the .exe installer.
• Configure options as needed during installation.

Note

• Default Draft Export does not distinguish between versions.
• For Capcut Material Extractor, download version 5.9 or below.