don

UCI Chess Engine

https://github.com/ehsanrashid/don

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.4%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

UCI Chess Engine

Basic Info
  • Host: GitHub
  • Owner: ehsanrashid
  • License: gpl-3.0
  • Language: C++
  • Default Branch: master
  • Homepage:
  • Size: 10.6 MB
Statistics
  • Stars: 11
  • Watchers: 6
  • Forks: 7
  • Open Issues: 2
  • Releases: 115
Created almost 13 years ago · Last pushed 10 months ago
Metadata Files
Readme Contributing License Citation

README.md

[![DON][DON128-logo]][website-link]

DON

A free and strong UCI chess engine.
[Explore DON docs »][wiki-link]

[Report bug][issue-link] · [Open a discussion][discussions-link] · [Discord][discord-link] · [Blog][website-blog-link] [![Build][build-badge]][build-link] [![License][license-badge]][license-link]
[![Release][release-badge]][release-link] [![Commits][commits-badge]][commits-link]
[![Website][website-badge]][website-link] [![Fishtest][fishtest-badge]][fishtest-link] [![Discord][discord-badge]][discord-link]

Overview

DON is a free and strong UCI chess engine derived from Stockfish that analyzes chess positions and computes the optimal moves.

DON does not include a graphical user interface (GUI) that is required to display a chessboard and to make it easy to input moves. These GUIs are developed independently from DON and are available online. Read the documentation for your GUI of choice for information about how to use DON with it.

See also the DON documentation for further usage help.

Files

This distribution of DON consists of the following files:

  • README.md, the file you are currently reading.

  • Copying.txt, a text file containing the GNU General Public License version 3.

  • src, a subdirectory containing the full source code, including a Makefile that can be used to compile DON on Unix-like systems.

  • a file with the .nnue extension, storing the neural network for the NNUE evaluation. Binary distributions will have this file embedded.

Contributing

See Contributing Guide.

Donating hardware

Improving DON requires a massive amount of testing. You can donate your hardware resources by installing the Fishtest Worker and viewing the current tests on Fishtest.

Improving the code

In the chessprogramming wiki, many techniques used in DON are explained with a lot of background information. The section on DON describes many features and techniques used by DON. However, it is generic rather than focused on DON's precise implementation.

The engine testing is done on Fishtest. If you want to help improve DON, please read this guideline first, where the basics of DON development are explained.

Discussions about DON take place these days mainly in the DON Discord server. This is also the best place to ask questions about the codebase and how to improve it.

Compiling DON

DON has support for 32 or 64-bit CPUs, certain hardware instructions, big-endian machines such as Power PC, and other platforms.

On Unix-like systems, it should be easy to compile DON directly from the source code with the included Makefile in the folder src. In general, it is recommended to run make help to see a list of make targets with corresponding descriptions. An example suitable for most Intel and AMD chips:

cd src make -j profile-build

Detailed compilation instructions for all platforms can be found in our documentation. Our wiki also has information about the UCI commands supported by DON.

Terms of use

DON is free and distributed under the GNU General Public License version 3 (GPL v3). Essentially, this means you are free to do almost exactly what you want with the program, including distributing it among your friends, making it available for download from your website, selling it (either by itself or as part of some bigger software package), or using it as the starting point for a software project of your own.

The only real limitation is that whenever you distribute DON in some way, you MUST always include the license and the full source code (or a pointer to where the source code can be found) to generate the exact binary you are distributing. If you make any changes to the source code, these changes must also be made available under GPL v3.

Owner

  • Name: Ehsan Rashid
  • Login: ehsanrashid
  • Kind: user
  • Location: Karachi, Pakistan
  • Company: Home

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: DON
message: >-
  Please cite this software using the metadata from this
  file.
type: software
authors:
  - name: Ehsan Rashid
repository-code: 'https://github.com/ehsanrashid/DON'
url: 'https://donchess.org/'
repository-artifact: 'https://donchess.org/download/'
abstract: DON is a free and strong UCI chess engine.
keywords:
  - chess
  - artificial intelligence (AI)
  - tree search
  - alpha-beta search
  - neural networks (NN)
  - efficiently updatable neural networks (NNUE)
license: GPL-3.0

GitHub Events

Total
  • Create event: 437
  • Commit comment event: 2
  • Issues event: 2
  • Release event: 425
  • Watch event: 5
  • Delete event: 430
  • Issue comment event: 12
  • Push event: 650
  • Gollum event: 3
  • Pull request review event: 2
  • Pull request review comment event: 2
  • Pull request event: 72
Last Year
  • Create event: 437
  • Commit comment event: 2
  • Issues event: 2
  • Release event: 425
  • Watch event: 5
  • Delete event: 430
  • Issue comment event: 12
  • Push event: 650
  • Gollum event: 3
  • Pull request review event: 2
  • Pull request review comment event: 2
  • Pull request event: 72

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 1
  • Total pull requests: 37
  • Average time to close issues: about 17 hours
  • Average time to close pull requests: about 20 hours
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 3.0
  • Average comments per pull request: 0.11
  • Merged pull requests: 22
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 37
  • Average time to close issues: about 17 hours
  • Average time to close pull requests: about 20 hours
  • Issue authors: 1
  • Pull request authors: 2
  • Average comments per issue: 3.0
  • Average comments per pull request: 0.11
  • Merged pull requests: 22
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • hafaba (1)
Pull Request Authors
  • ehsanrashid (36)
  • Zerbinati (1)
Top Labels
Issue Labels
Pull Request Labels