alpha-zero-general

(★ 4,502)

A clean implementation based on AlphaZero for any game in any framework + tutorial + Othello/Gobang/TicTacToe/Connect4 and more

파일 탐색기

최종 버전 다운로드 (.zip)

- - __init__.py
  - Connect4NNet.py
  - NNet.py
- __init__.py
- Connect4Game.py
- Connect4Logic.py
- Connect4Players.py
- README.md
- test_connect4.py
- Dockerfile.pytorch
- jupyter_notebook_config.py
- requirements.txt
- run_jupyter.sh
- - __init__.py
  - DotsAndBoxesNNet.py
  - NNet.py
- __init__.py
- Convert Keras Model for use with Tensorflow.js.ipynb
- DotsAndBoxesGame.py
- DotsAndBoxesLogic.py
- DotsAndBoxesPlayers.py
- DotsAndBoxesServer.py
- DotsAndBoxesTest.py
- main-dotsandboxes.py
- pit-dotsandboxes.py
- Play Dots and Boxes using AlphaZero General.ipynb
- README.md
- Train Dots and Boxes using AlphaZero General.ipynb
- - GobangNNet.py
  - NNet.py
- __init__.py
- GobangGame.py
- GobangLogic.py
- GobangPlayers.py
- - __init__.py
  - NNet.py
  - OthelloNNet.py
- - __init__.py
  - NNet.py
  - OthelloNNet.py
- __init__.py
- OthelloGame.py
- OthelloLogic.py
- OthelloPlayers.py
- README.md
- 6x6.png
- writeup.pdf
- - NNet.py
  - RTSNNet.py
- - README.md
- - Board.py
  - config.py
  - config_class.py
  - encoders.py
- - rts_pygame.py
  - rts_ue4.py
- install.sh
- learn.py
- pit.py
- README.md
- RTSGame.py
- RTSPlayers.py
- SANTORINI_README.md
- SantoriniGame.py
- SantoriniLogic.py
- SantoriniPlayers.py
- - __init__.py
  - NNet.py
  - TaflNNet.py
- - __init__.py
  - NNet.py
  - TaflNNet.py
- __init__.py
- Digits.py
- GameVariants.py
- mainTafl.py
- pitTafl.py
- TaflGame.py
- TaflLogic.py
- TaflPlayers.py
- - __init__.py
  - NNet.py
  - TicTacToeNNet.py
- - best.pth.tar.data-00000-of-00001
- __init__.py
- README.md
- TicTacToeGame.py
- TicTacToeLogic.py
- TicTacToePlayers.py
- - __init__.py
  - NNet.py
  - TicTacToeNNet.py
- README.md
- TicTacToeGame.py
- TicTacToeLogic.py
- TicTacToePlayers.py
.gitignore
Arena.py
Coach.py
Game.py
LICENSE
main.py
MCTS.py
NeuralNet.py
pit.py
README.md
requirements.txt
setup_env.sh
test_all_games.py
utils.py

🚀 설치 가이드

1. 코드 내려받기

git clone https://github.com/suragnair/alpha-zero-general

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd alpha-zero-general

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker exec -ti pytorch_notebook python main.py

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r docker/requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python main.py

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.