Skip to main content

Simple python Stockfish wrapper

Project description

PyPI version

Python Stockfish UCI Chess Engine wrapper

Getting Started:

pip install stockfishpy
  • Python 2.7
  • Download and make ‘Stockfish’ executable
  • Setup stockfish PATH in


Python console Example

>>> from stockfishpy.stockfishpy import *
>>> chessEngine = Engine(STOCKFISH_PATH, param={'Threads': 2, 'Ponder': 'true'})
>>> print chessEngine.uci()

>>> print chessEngine.isready()

>>> chessEngine.ucinewgame()
>>> chessEngine.setposition('rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1')
>>> move = chessEngine.bestmove()
>>> print move['bestmove']

>>> print move['ponder']

>>> print move['info']
info depth 12 seldepth 16 multipv 1 score cp -32 nodes 296597 nps 2879582 tbhits 0 time 103 pv e7e5 g1f3 b8c6 f1b5 g8f6 d2d3 f8c5 e1g1 e8g8 b5c6 d7c6 f3e5 d8e7

>>> chessEngine.ucinewgame()
>>> chessEngine.setposition(['e2e4', 'e7e5', 'g1f3'])
>>> move = chessEngine.bestmove()
>>> print move['bestmove']


  • Setup stockfish PATH in
  • Execute


This project is licensed under the GPLv3 see the LICENSE file for details

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (8.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page