Preparation ⚙️

• Third-party Account Registration and Environment Variable Configuration (API Key)
• Required Software Installation

Account Registration (Third-party)

All options are free.

Model Libraries

Huggingface

Application link: https://huggingface.co/settings/tokens

Note

Requires VPN or proxy access.

Language Models

Google Gemini

Application link: https://aistudio.google.com/apikey

Recommendation level: 🔥🔥🔥🔥🔥 Free quota sufficient for daily use.

Note

Requires VPN or proxy access.

DashScope Qwen

Application link: https://bailian.console.aliyun.com/console?tab=model#/api-key

New users receive 1 million free tokens.

Note

Validity period is generally 30 ~ 180 days.

Auxiliary Tools

Ngrok (Local to Public Network Tunneling)

Application link: https://dashboard.ngrok.com/domains

Info

Optional, 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 <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:

• 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 specified repository URL.
git pull	Pull the latest content.

Note

1. Avoid spaces and non-ASCII characters in paths when using git clone to prevent unexpected issues.
2. Use git pull inside the cloned CreatorBox folder to update the code directly.

Video Editing: JianYing

JianYing 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

1. Default Draft Export does not distinguish between versions.
2. For Jianying Material Extractor, download version 5.9 or below.