https://github.com/hyugit/stockfish-server
A minimal standalone server running stockfish.js engine written in nodejs
https://github.com/hyugit/stockfish-server
chess chess-engine nodejs nodejs-server standalone stockfish stockfish-engine
Last synced: 8 days ago
JSON representation
A minimal standalone server running stockfish.js engine written in nodejs
- Host: GitHub
- URL: https://github.com/hyugit/stockfish-server
- Owner: hyugit
- License: gpl-3.0
- Created: 2019-11-23T23:16:01.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-11-04T20:59:53.000Z (almost 2 years ago)
- Last Synced: 2025-02-25T22:43:13.301Z (8 months ago)
- Topics: chess, chess-engine, nodejs, nodejs-server, standalone, stockfish, stockfish-engine
- Language: JavaScript
- Homepage:
- Size: 505 KB
- Stars: 12
- Watchers: 2
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: Copying.txt
Awesome Lists containing this project
README
# stockfish-server
A minimal standalone server running stockfish.js engine written in nodejs
## Getting started
_**Non developers please see below**_ 👇
Make sure you have node and npm installed. Clone the repo, and run `npm i && npm start`. You can also run `npm link` to be able to run the app from anywhere in your system.
**Alternatively**, you can compile the repo by running `npm i && npm run-script package`, and get a standalone binary for your operating system.
Once it is running, you can use the **test.sh** script in this repo to try out the functionality.
## How does it work
It takes a [fen string](https://www.chessprogramming.org/Forsyth-Edwards_Notation) of a chess game, puts it through a [stockfish(js)](https://github.com/nmrugg/stockfish.js) chess engine, analyzes the puzzle, and returns the best move.
## For Non Developers
You can simply go to [releases](https://github.com/hyugit/stockfish-server/releases) section, and download the latest standalone binary for your OS.
If you want to test its functionality in real games, [ChessBulldozer](https://github.com/hyugit/ChessBulldozer) is a plugin to use on Chess.com that is developed to work with this **stockfish-server** application.
### Disclaimer
USE IT AT YOUR OWN RISK!
Please do not use [ChessBulldozer](https://github.com/hyugit/ChessBulldozer) plugin to crush your opponents like insects 😓. I was banned from Chess.com after using it to **continuously win about 20 perfect games in one sitting**, not to mention hours of my life I will never get back..
## Todo (Help wanted)
- automate building and release process
- fen string regex filter
- use GET instead of POST
- safely decode uri components
## License
The stockfish engine is GPLv3 licensed. So this project is also GPLv3.