===============================================
Deployment Checklist
===============================================

Before Copying Project
======================

On source computer, verify:

□ requirements.txt exists and is up-to-date
  Command: pip freeze > requirements.txt

□ All core files present:
  □ tts_batch_gui.py
  □ batch_generate.py
  □ indextts/ folder
  □ checkpoints/ folder
  □ assets/ folder
  □ i18n.json
  □ config.json

□ Deployment files ready:
  □ setup_new_location.bat
  □ requirements.txt
  □ QUICK_SETUP_GUIDE.txt
  □ README_DEPLOYMENT.txt

□ Test locally before sharing:
  □ GUI launches successfully
  □ Can generate audio
  □ All features work


Files to Copy
=============

Essential (MUST copy):
----------------------
□ tts_batch_gui.py
□ batch_generate.py
□ indextts/
□ checkpoints/
□ assets/
□ i18n.json
□ config.json
□ setup_new_location.bat
□ requirements.txt
□ run_tts_gui.bat
□ start_gui.pyw
□ QUICK_SETUP_GUIDE.txt
□ LICENSE*.txt

Optional:
---------
□ examples/
□ docs/
□ tools/
□ README files

SKIP (do NOT copy):
-------------------
□ venv/
□ venv_old/
□ __pycache__/
□ temp/
□ build/
□ outputs/
□ *.log
□ *.pyc


On Target Computer
==================

Prerequisites:
--------------
□ Python 3.10+ installed
  Check: python --version

□ Python in system PATH
  Check: python --version works

□ Internet connection available

□ ~8GB free disk space


Deployment Steps:
-----------------
□ Step 1: Copy project folder to desired location

□ Step 2: Navigate to project folder

□ Step 3: Run setup_new_location.bat
  - Should complete without errors
  - Watch for any error messages

□ Step 4: Wait for completion (3-5 minutes)


Verification:
-------------
□ Virtual environment created
  Check: venv\Scripts\python.exe exists

□ Dependencies installed
  Check: No error messages during install

□ Required files verified
  Check: Script reports all files OK

□ Can launch GUI
  Run: run_tts_gui.bat

□ GUI window appears

□ Can switch language

□ Can select audio file

□ Can generate test audio


Post-Deployment
===============

□ Test single sentence generation

□ Test batch processing

□ Verify GPU detection (if available)
  Or confirm CPU mode works

□ Check emotion controls

□ Test multi-language UI

□ Verify all features work as expected


Troubleshooting Checklist
==========================

If setup fails:
---------------
□ Python version is 3.10 or higher?

□ Internet connection active?

□ Enough disk space?

□ Run as administrator?

□ Antivirus blocking?

□ Firewall blocking pip?


If GUI won't start:
-------------------
□ Virtual environment created?
  Check: venv\ folder exists

□ Dependencies installed?
  Run: venv\Scripts\pip list

□ Required files present?
  Check: checkpoints\config.yaml exists

□ Try manual start:
  venv\Scripts\python.exe tts_batch_gui.py


If errors occur:
----------------
□ Check console output for error messages

□ Verify all files copied correctly

□ Try reinstalling dependencies:
  venv\Scripts\activate
  pip install -r requirements.txt --force-reinstall

□ Check Python version compatibility

□ Consult QUICK_SETUP_GUIDE.txt


Sharing with Others
===================

Before sharing:
---------------
□ Test deployment yourself first

□ Include QUICK_SETUP_GUIDE.txt

□ Include README_DEPLOYMENT.txt

□ Mention Python 3.10+ requirement

□ Provide support contact info


Tell recipients:
----------------
1. Install Python 3.10+ if not already installed
   https://www.python.org/downloads/

2. Extract project folder

3. Run setup_new_location.bat

4. Launch with run_tts_gui.bat

5. Read QUICK_SETUP_GUIDE.txt if issues occur


Success Criteria
================

Deployment is successful if:

✓ setup_new_location.bat completes without errors
✓ GUI launches and displays correctly
✓ Can generate audio successfully
✓ All UI features respond correctly
✓ Language switching works
✓ No error messages in console


Common Success Indicators:
---------------------------
✓ "部署完成！" message appears
✓ "所有必需文件完整" confirmed
✓ GUI window appears normally
✓ Can see emotion sliders
✓ Can load audio files
✓ Task list shows empty initially


Additional Notes
================

First-time setup takes 3-5 minutes:
- Creating virtual environment: ~30s
- Installing dependencies: 2-4min
- Verifying files: ~10s

Subsequent launches are instant.

Dependencies are downloaded from PyPI.
Total download size: ~500MB-1GB

Disk space after setup:
- Python packages: ~2GB
- Model files: 5-10GB
- Total: ~7-12GB


===============================================
Last Updated: 2025-11-22
Version: 1.0
===============================================

