0Xiaohei0/LocalAIVtuber2

Fully local AI vtuber that can see your screen and talk in real time

Python

245

151 commits

updated Feb 14, 2026

See the code

README

Local AI Vtuber 2 (Fully local AI vtuber that can see your screen and talk in real time)

Full demo and setup guide: https://youtu.be/gD1y4by3CPg?si=oinKcReuUd5xzjKT

  • All AI models run locally.
  • Can chat about what's on your screen.
  • Can be interrupted mid-sentence.
  • Modern web UI with 2D and 3D character rendering.
  • Custom finetuned language model for more interesting conversations.
  • Long term memory storage and retrieval.
  • Can edit conversations and export as training data.

System requirements

OS: Windows

GPU: NVIDIA GPU 40 series or older, recommend ~8gb vram

Install

Windows

If you are a Windows user, you can download the release package here, unzip and double click start.bat to start webui: https://huggingface.co/xiaoheiqaq/LocalAiVtuber2-windows-package/resolve/main/LocalAIVtuber2.zip?download=true

Install Manually

1. Install python 3.10

https://www.python.org/downloads/release/python-3100/

2. Install CUDA toolkit 12.4

https://developer.nvidia.com/cuda-12-4-0-download-archive

3. Create environemnt

cd backend
python -m venv venv
.\venv\Scripts\activate

4. Install dependencies

pip install llama-cpp-python==0.2.90 --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu124
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
pip install fastapi uvicorn qdrant-client[fastembed] pyautogui  sounddevice silero-vad easyocr==1.7.2 mss numpy==1.23.4 pytchat soxr
pip install -r services\TTS\GPTsovits\requirements.txt

5. Start program

.\venv\Scripts\activate
python server.py

After setup, you can also double click the start.bat file to start the program without needing to open the terminal.

Setting up from a clone

This is for if you want to clone the repo for contributing to this project

1. Clone the repo and follow the envrionemnt setup as described above

2. Get the pretrained TTS model from the release package

Copy this folder in the release package backend\services\TTS\GPTsovits\GPT_SoVITS\pretrained_models to the same location in the cloned project.

3. Get ffmpeg from the release package

Copy backend\ffmpeg.exe and backend\ffprobe.exe to same path in cloned project

4. Build frontend

Install nodejs https://nodejs.org/en/download

cd frontend
npm i
npm run build

The project should be ready for development.

FAQ

nltk error

image

Open a terminal any where and run

pip install nltk
python -m nltk.downloader -d C:\nltk_data all

Known issues

NVIDIA 50 series GPU requires newer cuda versions which are not compatable right now

AMD GPU does not support pytorch on windows so not compatable

Contributors

0Xiaohei0

151 commits

0Xiaohei0/LocalAIVtuber2

Fully local AI vtuber that can see your screen and talk in real time

Python

245

151 commits

updated Feb 14, 2026

See the code

README

Local AI Vtuber 2 (Fully local AI vtuber that can see your screen and talk in real time)

Full demo and setup guide: https://youtu.be/gD1y4by3CPg?si=oinKcReuUd5xzjKT

  • All AI models run locally.
  • Can chat about what's on your screen.
  • Can be interrupted mid-sentence.
  • Modern web UI with 2D and 3D character rendering.
  • Custom finetuned language model for more interesting conversations.
  • Long term memory storage and retrieval.
  • Can edit conversations and export as training data.

System requirements

OS: Windows

GPU: NVIDIA GPU 40 series or older, recommend ~8gb vram

Install

Windows

If you are a Windows user, you can download the release package here, unzip and double click start.bat to start webui: https://huggingface.co/xiaoheiqaq/LocalAiVtuber2-windows-package/resolve/main/LocalAIVtuber2.zip?download=true

Install Manually

1. Install python 3.10

https://www.python.org/downloads/release/python-3100/

2. Install CUDA toolkit 12.4

https://developer.nvidia.com/cuda-12-4-0-download-archive

3. Create environemnt

cd backend
python -m venv venv
.\venv\Scripts\activate

4. Install dependencies

pip install llama-cpp-python==0.2.90 --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu124
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
pip install fastapi uvicorn qdrant-client[fastembed] pyautogui  sounddevice silero-vad easyocr==1.7.2 mss numpy==1.23.4 pytchat soxr
pip install -r services\TTS\GPTsovits\requirements.txt

5. Start program

.\venv\Scripts\activate
python server.py

After setup, you can also double click the start.bat file to start the program without needing to open the terminal.

Setting up from a clone

This is for if you want to clone the repo for contributing to this project

1. Clone the repo and follow the envrionemnt setup as described above

2. Get the pretrained TTS model from the release package

Copy this folder in the release package backend\services\TTS\GPTsovits\GPT_SoVITS\pretrained_models to the same location in the cloned project.

3. Get ffmpeg from the release package

Copy backend\ffmpeg.exe and backend\ffprobe.exe to same path in cloned project

4. Build frontend

Install nodejs https://nodejs.org/en/download

cd frontend
npm i
npm run build

The project should be ready for development.

FAQ

nltk error

image

Open a terminal any where and run

pip install nltk
python -m nltk.downloader -d C:\nltk_data all

Known issues

NVIDIA 50 series GPU requires newer cuda versions which are not compatable right now

AMD GPU does not support pytorch on windows so not compatable

Contributors

0Xiaohei0

151 commits

Languages

Python

83.9%

TypeScript

15.1%