System Requirements

Before installing CharaStudio, make sure your computer meets the following minimum requirements:

Downloading the Installer

Visit the CharaStudio download page to get the latest version of the installer.

Windows Installation

1. Download the .exe installer
2. Double-click to run the installer
3. Follow the installation wizard
4. On first launch, CharaStudio will automatically download the required AI models (~3-5 GB)

# Or install via command line
winget install CharaStudio

macOS Installation

1. Download the .dmg disk image
2. Open the image and drag CharaStudio into the Applications folder
3. On first launch, if prompted "Cannot open", go to System Preferences > Security & Privacy to allow

Linux Installation

# Debian/Ubuntu (.deb)
sudo dpkg -i charastudio_*.deb

# AppImage (universal)
chmod +x CharaStudio-*.AppImage
./CharaStudio-*.AppImage

Initial Setup

On first launch, follow these steps to complete the initial configuration:

1. Select Language: Choose your preferred interface language on the welcome screen (Simplified Chinese / English / Japanese)
2. Configure Storage Path: Choose where to store project files, AI models, and cache data
3. Download AI Models: On first use, CharaStudio will prompt you to download the required AI models
4. Sign In (Optional): You can skip account login and use offline features directly

Verifying the Installation

After installation, open CharaStudio. If you see the main interface, the installation was successful. Try the following to verify the full feature set:

• Create a new character
• Start a new story project
• Explore the asset library

Troubleshooting

Error: "AI Model Not Found"

This means the AI models haven't been downloaded. Go to Settings > AI Models and click the "Download Models" button.

GPU Acceleration Not Working

1. Go to Settings > Performance
2. Make sure "Enable GPU Acceleration" is checked
3. Verify your graphics drivers are up to date

How to Change Data Storage Path

Go to Settings > Storage to modify the data storage location at any time. Note: existing project files won't be moved automatically — you'll need to migrate them manually.