Metadata-Version: 2.4
Name: fairyfishnet
Version: 1.16.54
Summary: Distributed Fairy-Stockfish analysis for pychess-variants
Home-page: https://github.com/gbtami/fairyfishnet
Author: Bajusz Tamás
Author-email: gbtami@gmail.com
Keywords: lichess.org chess stockfish uci
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Games/Entertainment :: Board Games
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: requests==2.32.4
Requires-Dist: pyffish==0.0.88
Requires-Dist: gdown==5.2.0
Requires-Dist: beautifulsoup4==4.12.3
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

fairyfishnet: distributed Fairy-Stockfish analysis for pychess.org
==================================================================

.. image:: https://badge.fury.io/py/fairyfishnet.svg
    :target: https://pypi.python.org/pypi/fairyfishnet

Installation
------------

1. Request your personal fairyfishnet key on pychess Discord https://discord.gg/aPs8RKr
2. Install the fairyfishnet client.

   **Via pip**

   To install or upgrade to the latest version do:

   ::

       pip3 install --upgrade --user fairyfishnet

   Example usage:

   ::

       python3 -m fairyfishnet --auto-update

   Optional: Generate a systemd service file:

   ::

       python3 -m fairyfishnet systemd

   **Via Docker**

   There is a `Docker container <https://hub.docker.com/r/mklemenz/fishnet/>`_
   courtesy of `@mklemenz <https://github.com/mklemenz>`_. For example you can
   simply do:

   ::

       docker run mklemenz/fishnet --key MY_APIKEY --auto-update

pychess-variants custom Fairy-Stockfish
---------------------------------------

fairyfishnet is using
`Fairy-Stockfish <https://github.com/ianfab/Fairy-Stockfish>`__
by `@ianfab <https://github.com/ianfab/Fairy-Stockfish>`_.

You can build Fairy-Stockfish yourself (for example with ``./build-stockfish.sh``)
and provide the path using ``python -m fairyfishnet --stockfish-command``. Otherwise
a precompiled binary will be downloaded for you.

Overview
--------

.. image:: https://raw.githubusercontent.com/gbtami/fairyfishnet/master/doc/sequence-diagram.png

See `protocol.md <https://github.com/gbtami/fairyfishnet/blob/master/doc/protocol.md>`_ for details.

License
-------

fairyfishnet is licensed under the GPLv3+ license. See LICENSE.txt for the full
license text.
