This repository has been archived on 2023-03-04. You can view files and clone it, but cannot push or open issues or pull requests.
Vatu/README.md

87 lines
2.1 KiB
Markdown

Vatu
====
Dumb chess engine written in Rust for fun.
Features
--------
- [UCI][cpw-uci]
- Barely optimized board, position and moves representations
- Simple [negamax][cpw-negamax] for node evaluation
- [Alpha-beta][cpw-ab] search tree pruning for speeding searches
[cpw-uci]: https://www.chessprogramming.org/UCI
[cpw-negamax]: https://www.chessprogramming.org/Negamax
[cpw-ab]: https://www.chessprogramming.org/Alpha-Beta
Last time I checked it ran approximately at 10000 nps.
Thanks to UCI the bot can run with most compatible software; [Cutechess][cc] has
been used for testing.
[cc]: https://github.com/cutechess/cutechess
Usage
-----
### Build
With Cargo:
```bash
cargo build --release
```
With Docker, to avoid setting up a Rust toolchain:
```bash
docker build -f res/docker/Dockerfile -t vatu-builder --target builder .
docker create vatu-builder # Returns a container ID.
docker cp <id>:/src/target/release/vatu .
docker rm <id>
docker rmi vatu-builder
```
### Run
If you built it with Cargo, the binary is in `target/release`.
```bash
./vatu
```
To run your own instance of the bot on Lichess (why would you do that?), create
a bot account and get an OAuth token. Then using the full Docker image:
```bash
# Fetch the lichess-bot submodule.
git submodule update --init --recursive
# Copy the config.yml template to your own copy and modify it.
cp external/lichess-bot/config.yml.example /tmp/vatu-config/config.yml
# Build the image. Make sure config.yml is not there to not embed it!
docker build -f res/docker/Dockerfile -t vatu .
# Run with the config folder mounted at /config.
docker run -v /tmp/vatu-config:/config -ti vatu
# In the container, use the following command:
python lichess-bot.py --config /config/config.yml
```
TODO
----
- [X] Support time constraints
- [ ] Unmake mechanism instead of allocating nodes like there is no tomorrow
- [X] Precompute some pieces moves, maybe (done for knights)
- [ ] Transposition table that does not actually slows search down
- [ ] Check Zobrist hashes for previous point
- [X] Actual bitboard
- [ ] Some kind of move ordering could be great
- [ ] Multithreading (never)