UCI creator guide

Create your UCI engine and play against your clone in Fritz, ChessBase or Arena.

1Prepare the folder

Create a folder and download these files:

  1. AvatarEngine.py📥 Download
  2. install_engine.bat📥 Download
  3. Stockfish🔗 stockfishchess.org
  4. Your JSON profile (generated from the homepage)

⚠️ Windows will display a warning

This is normal! Windows protects against downloaded .bat files. Click "More info" then "Run anyway".

💡 The code is 100% open source and visible in the downloaded files.

✨ The script automatically detects your JSON file, keep its original name!

2Run the installation

Double-click on install_engine.bat (the script will request administrator rights). Follow the instructions to compile AvatarEngine.exe with PyInstaller.

3Configure your software

In Fritz 20/ChessBase

  1. Open File → Open → Engines (or Module → UCI Module)
  2. Click New Engine / ... to browse
  3. Select AvatarEngine.exe
  4. Your bot appears in the list!

In Arena

  1. Open Engines → Install new engine
  2. Select AvatarEngine.exe
  3. Your bot appears in the list!
⚠️Common Issues

pip blocked (Device Guard) / PyInstaller unavailable

Contact your administrator to allow pip, or compile AvatarEngine.exe on a PC where pip works and copy the exe.

Windows blocks the .bat file

Right-click → Properties → Check "Unblock" → OK

Python not found

Install Python from python.org (check "Add Python to PATH")

Engine not responding

Check that Stockfish and profile.json are in the same folder as AvatarEngine.exe.