chess-tuning-tools


Namechess-tuning-tools JSON
Version 0.9.5 PyPI version JSON
download
home_pagehttps://github.com/kiudee/chess-tuning-tools
SummaryA collection of tools for local and distributed tuning of chess engines.
upload_time2023-07-19 15:49:09
maintainer
docs_urlNone
authorKarlson Pfannschmidt
requires_python>=3.8,<3.10
licenseApache-2.0
keywords chess tuning optimization engine
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
.. image:: https://raw.githubusercontent.com/kiudee/chess-tuning-tools/master/docs/_static/CTT-Plots.png

.. image:: https://raw.githubusercontent.com/kiudee/chess-tuning-tools/master/docs/_static/logo.png

.. image:: https://readthedocs.org/projects/chess-tuning-tools/badge/?version=latest&style=flat-square
        :target: https://chess-tuning-tools.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://zenodo.org/badge/234719111.svg?style=flat-square
   :target: https://zenodo.org/badge/latestdoi/234719111


A collection of tools for local and distributed tuning of chess engines.


* Free software: Apache Software License 2.0
* Documentation: https://chess-tuning-tools.readthedocs.io.


Features
--------



* Optimization of chess engines using state-of-the-art `Bayesian optimization <https://github.com/kiudee/bayes-skopt>`_.
* Support for automatic visualization of the optimization landscape.
* Scoring matches using a Bayesian-pentanomial model for paired openings.

Quick Start
-----------

In order to be able to start the tuning, first create a python
environment (at least Python 3.7) and install chess-tuning-tools by typing::

   pip install chess-tuning-tools

Furthermore, you need to have `cutechess-cli <https://github.com/cutechess/cutechess>`_
in the path. The tuner will use it to run matches.

To execute the local tuner, simply run::

   tune local -c tuning_config.json

Take a look at the `usage instructions`_ and the `example configurations`_ to
learn how to set up the ``tuning_config.json`` file.

Installation on Windows
^^^^^^^^^^^^^^^^^^^^^^^

To get chess-tuning-tools to work on Windows, the easiest way is to install
the `Miniconda <https://docs.conda.io/en/latest/miniconda.html>`_ distribution.
Then, create a new environment and install chess-tuning-tools::

   conda create -n myenv python=3.9 scikit-learn=0.23
   activate myenv
   pip install chess-tuning-tools

.. _example configurations: https://github.com/kiudee/chess-tuning-tools/tree/master/examples
.. _usage instructions: https://chess-tuning-tools.readthedocs.io/en/latest/usage.html

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/kiudee/chess-tuning-tools",
    "name": "chess-tuning-tools",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<3.10",
    "maintainer_email": "",
    "keywords": "chess,tuning,optimization,engine",
    "author": "Karlson Pfannschmidt",
    "author_email": "kiudee@mail.upb.de",
    "download_url": "https://files.pythonhosted.org/packages/e8/2d/b4b328346a72611ebc3bd275bb19466b034f0066c908087bc8e4f459890e/chess_tuning_tools-0.9.5.tar.gz",
    "platform": null,
    "description": "\n.. image:: https://raw.githubusercontent.com/kiudee/chess-tuning-tools/master/docs/_static/CTT-Plots.png\n\n.. image:: https://raw.githubusercontent.com/kiudee/chess-tuning-tools/master/docs/_static/logo.png\n\n.. image:: https://readthedocs.org/projects/chess-tuning-tools/badge/?version=latest&style=flat-square\n        :target: https://chess-tuning-tools.readthedocs.io/en/latest/?badge=latest\n        :alt: Documentation Status\n\n.. image:: https://zenodo.org/badge/234719111.svg?style=flat-square\n   :target: https://zenodo.org/badge/latestdoi/234719111\n\n\nA collection of tools for local and distributed tuning of chess engines.\n\n\n* Free software: Apache Software License 2.0\n* Documentation: https://chess-tuning-tools.readthedocs.io.\n\n\nFeatures\n--------\n\n\n\n* Optimization of chess engines using state-of-the-art `Bayesian optimization <https://github.com/kiudee/bayes-skopt>`_.\n* Support for automatic visualization of the optimization landscape.\n* Scoring matches using a Bayesian-pentanomial model for paired openings.\n\nQuick Start\n-----------\n\nIn order to be able to start the tuning, first create a python\nenvironment (at least Python 3.7) and install chess-tuning-tools by typing::\n\n   pip install chess-tuning-tools\n\nFurthermore, you need to have `cutechess-cli <https://github.com/cutechess/cutechess>`_\nin the path. The tuner will use it to run matches.\n\nTo execute the local tuner, simply run::\n\n   tune local -c tuning_config.json\n\nTake a look at the `usage instructions`_ and the `example configurations`_ to\nlearn how to set up the ``tuning_config.json`` file.\n\nInstallation on Windows\n^^^^^^^^^^^^^^^^^^^^^^^\n\nTo get chess-tuning-tools to work on Windows, the easiest way is to install\nthe `Miniconda <https://docs.conda.io/en/latest/miniconda.html>`_ distribution.\nThen, create a new environment and install chess-tuning-tools::\n\n   conda create -n myenv python=3.9 scikit-learn=0.23\n   activate myenv\n   pip install chess-tuning-tools\n\n.. _example configurations: https://github.com/kiudee/chess-tuning-tools/tree/master/examples\n.. _usage instructions: https://chess-tuning-tools.readthedocs.io/en/latest/usage.html\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "A collection of tools for local and distributed tuning of chess engines.",
    "version": "0.9.5",
    "project_urls": {
        "Bug Tracker": "https://github.com/kiudee/chess-tuning-tools/issues",
        "Documentation": "https://chess-tuning-tools.readthedocs.io",
        "Homepage": "https://github.com/kiudee/chess-tuning-tools",
        "Repository": "https://github.com/kiudee/chess-tuning-tools"
    },
    "split_keywords": [
        "chess",
        "tuning",
        "optimization",
        "engine"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0275593b06a199a89755b846da05ab3297ffb92b4566b0160fa599a60fde4f88",
                "md5": "a0ab554478bc9de1765fcdc647503119",
                "sha256": "53b27ea844bfa5c9630e70a1428ffc80fccbbaf7a1fc6f7365da454e5759c58b"
            },
            "downloads": -1,
            "filename": "chess_tuning_tools-0.9.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a0ab554478bc9de1765fcdc647503119",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<3.10",
            "size": 48318,
            "upload_time": "2023-07-19T15:49:07",
            "upload_time_iso_8601": "2023-07-19T15:49:07.532581Z",
            "url": "https://files.pythonhosted.org/packages/02/75/593b06a199a89755b846da05ab3297ffb92b4566b0160fa599a60fde4f88/chess_tuning_tools-0.9.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e82db4b328346a72611ebc3bd275bb19466b034f0066c908087bc8e4f459890e",
                "md5": "c88c0b50b8787504b9afd06ea78ceca1",
                "sha256": "18929382f05efa629d3d0ad3906eb1d22b88a2dd0a4c6bc606526f801573753a"
            },
            "downloads": -1,
            "filename": "chess_tuning_tools-0.9.5.tar.gz",
            "has_sig": false,
            "md5_digest": "c88c0b50b8787504b9afd06ea78ceca1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<3.10",
            "size": 43056,
            "upload_time": "2023-07-19T15:49:09",
            "upload_time_iso_8601": "2023-07-19T15:49:09.194098Z",
            "url": "https://files.pythonhosted.org/packages/e8/2d/b4b328346a72611ebc3bd275bb19466b034f0066c908087bc8e4f459890e/chess_tuning_tools-0.9.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-07-19 15:49:09",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "kiudee",
    "github_project": "chess-tuning-tools",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "chess-tuning-tools"
}
        
Elapsed time: 1.89762s