Skip to content

This is the learning environment for Freeciv 3.1 with python bindings for advancements in RL. This is the first project of it's kind in the world and will also be the most challenging environment out there.

License

Notifications You must be signed in to change notification settings

yashbonde/freeciv-python

Repository files navigation

alt_text

UNDER DEVELOPMENT PRE-RELEASE

alt_text alt_text

This is the official python environment for Freeciv 3.1 for advancement in deep reinforcement learning. Freeciv is an open source multiplayer turn based strategy game inspired from Civilizations. The vastness of game through its state and action space makes it a formidible challenge to both humans and AI alike. Read about the idea here, and why it is of such importance.

I have shifted most of my work in freeciv to a seperate repo and kept only the source files here. For some research materials go to /research-papers folder in the other repo. The code base is initially designed for freeciv-desktop version but it will be modular enough so we can plug it to freeciv-web version as well.

Sample

Given below is a sample action replay of an agent moving around in the world. Status refers to the area explored and Explored Terrain is what it sees moving around in the world.

alt_text

Vision

This environment will single handedly be one of the most difficult open-sourced learning environments. I aim to make this at the forefront of deep RL research, to push the boundaries of what can be done. The end goal is to create an agent which can learn by itself (also creating the baseline model as this develops).

We also regulate the version number and count to make it most efective, currenty we are on version 0.4 corresponding with the percentage of work done. Version 1.0 is what we want make the first release version.

Installing The Game

You can install the game from the main repo by looking at the INSTALL in docs. Though this is a bit tricky on macOS and requires installation of various packages.

macOS

You can play the game simply by downloading the macOS package here and running the .pkg file.

Structure of Environment

The details of the environment are given in the /doc folder.

Update Logs

As the size of logs keeps increasing it has been shifted to doc/logs, some important milestones:

08.11.2018: Repo created with initial commit containing Monte Carlo Agent

About

This is the learning environment for Freeciv 3.1 with python bindings for advancements in RL. This is the first project of it's kind in the world and will also be the most challenging environment out there.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages