Open source · C++20 · UCI

Virgin

A UCI chess engine built for bots. Virgin is an aggressive, independent tactician; its strategic reliability still varies. Every part of its evaluation can be steered from the outside, so that character can be shaped into many different opponents.

215 ready-made bots, your own bots from a plain text file, and an adaptive mode that keeps a game winnable for the human player. One small file for Windows and Android.

Virgin is open source under the MIT license. Questions? Come to the Discord server electricchess.

The Virgin logo: a white chess queen with red flames

Try it now

Play against Virginia

The adaptive game of Virgin, right in your browser. Virginia keeps the game close and winnable for you. Nothing to install, and nothing is sent anywhere.

Playing against Virginia in the browser: the board, the mood queen, and the depth, evaluation and nodes of her calculation

Choose White or Black, choose the piece when a pawn promotes, take a move back. The queen shows how the game stands from your point of view, from radiant to lightning and fire, and next to her you see what Virginia is calculating: depth, evaluation and nodes. The engine runs on your device.

The idea

An engine you can shape

Most engines try to be as strong as possible. Virgin tries to be a good opponent.

Built for bots

A bot is a playing strength combined with a playing style. Virgin ships a catalogue of 215 bots (43 strength levels times 5 styles) and lets you define as many more as you like.

Every weight is adjustable

About 90 evaluation weights are exposed as UCI options and in one weights file. There is no NNUE and no opaque network: you can read, change and reload each value.

One small file

C++20 and no external libraries. The Windows binary is under 500 KB, the static Android binary stays under 1 MB. Windows and Android are built from the same code.

Plain UCI

Virgin is a process that speaks UCI over stdin and stdout. It works with any UCI host, such as BearChess, Arena or Cute Chess, and with your own app.

An attacking character

Virgin’s own character is a tactician that looks for the attack. Strategic reliability still varies, and that is part of what makes the bots feel different from each other.

Made for apps

The engine, the bot catalogue and the playing styles live in one binary, so an app only needs to start one process and send UCI commands.

New in 0.8.6 (beta): a stronger search

Version 0.8.6 of 15 November 2026 changes only the search; the evaluation and all UCI options stay as in 0.8.5. Futility pruning, late move pruning and late move reductions used to be off in every thin position; now they are off only in pure pawn endgames (a rook endgame reaches depth 12 instead of 8 in 1 s). Losing captures and quiet moves are pruned by SEE, a capture history orders captures better, and late move reductions are somewhat more aggressive. In self-play against 0.8.5 (1 thread, equal time) the single steps gained +45 to +115 Elo at 100 to 300 ms per move; at 400 ms the reduction change gained clearly less. There is no single overall figure against 0.8.5 and no measurement against other engines. Tested: Windows, compact core, WebAssembly, Linux x86_64. Not tested on devices: Android, Linux ARMv6/ARMv7, ESP32-S3.

Adaptive play

A game you can still win

The adaptive game of “Tal” from the app eChessTactics, built into the engine.

In adaptive mode Virgin does not try to crush its opponent. After every move it looks at the position from the human player’s point of view, analyses five candidate moves and chooses the one that keeps the game interesting and winnable. The aim is to lead the player into a position that can be won with good technique.

Opening

The first moves are the engine’s best moves, so the game starts as a normal game.

Roughly equal

Among the candidates it picks a move that keeps the balance, and now and then a different but equal one so that games do not repeat.

You are behind

It helps: it chooses a safe move that gives part of the advantage back, and it never sacrifices a queen or a rook to do it.

Far behind, or mate in sight

Full strength. No gifts when the game is clearly lost or a forced mate is near.

You are ahead

It keeps the position where it is for the rest of the game, so the win stays within reach and does not slip away.

Real tactics

When a sound tactic wins material it plays it. If you have been playing accurately in a balanced game, it may let a small advantage go, a few times per game.

Turn it on

setoption name Adaptive value true

Adaptive is a single UCI option. While it is on, Virgin ignores all the other strength and style options: it plays with full strength, five candidate moves, a fixed attacking profile and automatic threads, and the adaptive logic decides which move is played. Switching it off restores your previous settings. Because it analyses five candidates each turn, allow a few seconds per move. The engine reports every choice in an info string line: the mode it used, the evaluation from the player’s side and how accurately the player has been playing.

Make your own

Create a bot

A bot is a strength and a style. Pick one, mix one, or save your own as a text file.

The style axis is called Boldness, from cautious to reckless:

StyleMeaning
FurchtsamTimid: safety first, avoids sharp lines, accepts draws.
VorsichtigCautious: solid and positional.
AusgeglichenBalanced: the reference style, all weights at their defaults.
AngriffslustigAggressive: goes for the king, avoids queen trades.
StierBull: sacrifices, pawn storms, king hunts.

1. Pick one from the catalogue

setoption name Bot value v1200-stier

Bot ids look like v<elo>-<style>, for example v700-furchtsam, v1500-angriffslustig or v2800-ausgeglichen. The whole catalogue is in data/bots.txt; virgin --list-bots prints it, and virgin --gen-data also writes it as data/bots.json for apps.

2. Mix strength and style yourself

setoption name UCI_LimitStrength value true
setoption name UCI_Elo value 1250
setoption name Style value Angriffslustig
setoption name Boldness value 45

Boldness runs from 10 (timid) to 50 (bull) and interpolates between the styles. UCI_Elo accepts any whole number from 700 to 3000, not only the 50-point steps of the catalogue.

3. Tune single weights

setoption name Aggression.KingAttack value 260
setoption name Misc.MoveNoise value 40

4. Save your bot as a weights file

A bot is just a text file with Name = value lines:

# my-bot.txt
Aggression.KingAttack = 260
Aggression.PawnStorm = 180
Aggression.AvoidQueenTrade = 220
Misc.Contempt = 25
setoption name WeightsFile value C:\bots\my-bot.txt
setoption name ReloadWeights

data/weights_default.txt lists every weight with its default and range.

Reference

UCI options and commands

All the standard UCI commands, plus the options and commands below.

Options

OptionMeaning
BotSelects a catalogue bot such as v1200-stier and sets strength and style at once.
UCI_LimitStrength, UCI_EloLimit the playing strength (700 to 3000).
Style, BoldnessThe playing style and its fine control.
AdaptiveSwitches adaptive play on or off. While it is on, all other strength and style options are ignored.
WeightsFile, ReloadWeightsLoad your own weights file.
Misc.Contempt, Misc.MoveNoiseDraw attitude and randomness in the root move choice.
Hash, Threads, PonderHash size in MB, search threads, pondering.
<Group>.<Term>Every evaluation weight is a spin option, for example Aggression.KingAttack.

Commands

CommandWhat it does
uci, isready, ucinewgameThe usual UCI handshake.
setoption, position, go, stop, quitStandard. go understands depth, nodes, movetime, wtime/btime with increments, movestogo, infinite and ponder.
dShows the board.
evalShows the evaluation with a breakdown.
perft <n>, bench <n>Move generation check and a speed benchmark.
sanityA consistency check of the engine.
weightsLists all weights.
listbotsPrints the bot catalogue.

From the command line

virgin --selftest          # built-in test run
virgin --perft 5           # must print 4865609
virgin --list-bots         # the 215 bots
virgin --gen-data          # regenerate data\ (weights, styles, bot catalogue)

Version 0.8.6 Beta · 15 November 2026

Downloads

Ready-to-run packages, no installation. Virgin is a UCI engine: add the file to any UCI-capable chess program or board software as an engine. Every package also contains the engine license and the release notes.

What has been tested. Windows, the compact core, WebAssembly (in the Chrome browser) and Linux x86_64 (run under WSL) were executed and checked. Android, Linux ARMv6/ARMv7 and ESP32-S3 are built but have not been tested on devices: the Android and ARM Linux files were only checked structurally, and the ESP32-S3 firmware was built but not flashed. Use them with that in mind.

PlatformFileSizeStatusSHA-256Date
Windows x64Virgin-0.8.6-Windows.zip
UCI exe, DLL, C header
367 KBRun and checked4053c074983a0f13594b58de2ba44428961d29e012219c919607507ca9b041712026-11-15
Linux (x86_64, ARMv6, ARMv7)Virgin-0.8.6-Linux.zip
Static UCI engines with data
1.35 MBx86_64 run and checked (WSL); ARMv6 and ARMv7 built, not run on hardware2f635cd59cacb8ec8e9ff2620e12f4147b916b4fe41185d99ff43c81adb5c0c62026-11-15
Web (WebAssembly)Virgin-0.8.6-Web.zip
WASM, worker, demo page
237 KBRun and checked (Chrome)e7301a52b8a835488ce52f0fbfc3ad09f4faf30fe6f95a11a3fe9c37d0fcefff2026-11-15
AndroidVirgin-0.8.6-Android.zip
OEX app, AAR library, UCI binaries (arm64-v8a, armeabi-v7a, x86_64, x86)
6.9 MBBuilt, not tested on devices3bf9086cb4931c8ff3995f2b76ee004733dd0c2db6dd7ce2c359ebe8fe6022e02026-11-15
ESP32-S3Virgin-0.8.6-ESP32-S3.zip
Firmware for no PSRAM, QSPI PSRAM, OPI PSRAM
1.09 MBBuilt, not flashed5264bcb8e98fd4cea4659a37712278910fca2673818b23ef2a53874ac4adead22026-11-15

Checksums as files: Windows, Linux, Web, Android, ESP32-S3. Check a download in PowerShell with Get-FileHash Virgin-0.8.6-Windows.zip.

Release notes 0.8.6 (German) · Engine license (MIT). This is a beta release; the evaluation and all UCI options are unchanged from 0.8.5.

Older builds (0.7.1 and earlier) are in the builds folder on GitHub ↗.