Python Bots

[nicolodavis]

General plan to implement a Python client that people can use to write bots. The client will just use a websocket implementation to communicate with the Node server (there should be no changes server-side):

• Investigate Python websocket implementation.
• API for Python bots.
• Python bot for Tic-Tac-Toe.

[akaguny]

why pyton?)

[nicolodavis]

Python is an important language for the AI community and will open up many more possibilities.

[vdfdev]

To make things simpler, we could support some kind of communication between node <---> python, so we would not need to support websockets on python, or change our implementation.
We just need to flag this bot as "server only", to avoid trying to run it on the browser.

[francoijs]

Hey,
I had the same need for a python bot to replace one of the players. You can find a prototype here:
https://github.com/francoijs/TicTacBot
The bot plays TicTacToe (randomly) against the player: state and actions are exchanged with a python subprocess (using stdin/stdout). The main problem for the moment is that the bot has trouble emitting 'endTurn' and 'endPhase' events (it works somehow in the Tic-tac-toe example, but I never managed to get 'endPhase' events to the server with a more complex game)
I would love to have your feedback/suggestions!

[nicolodavis]

@francoijs This looks like a good first step in this direction!

Here are my thoughts:

It would be nice to have a Python API that abstracts away how the bot communicates with the server (and resembles the JS API). For example:

from boardgame.io import Bot

class TicTacToeBot(Bot):

  # Called when it is this bot's turn to play.
  def think(G, ctx):
    self.moves.clickCell(3)
    self.events.endTurn()

I personally think that it's much less messy if the bot just uses websockets behind the scenes and communicates with the server like any other JS client. This will allow the server code to remain untouched and you don't have to deal with stdin / stdout parsing.

[francoijs]

Thanks for the feedback, your design idea is indeed much cleaner. I will work toward adapting my prototype and get back to you.

[francoijs]

The prototype was updated: it now connects to the server using the Socket.IO python client and can emit actions until game is over. Next: emitting 'endTurn' and 'endPhase' events to support more complex games.
Example of instantiation:

from boardgameio import Bot

class TicTacToeBot(Bot):

    def __init__(self):
        Bot.__init__(self, server='localhost', port=8000, game_name='default', num_players=2, player_id='1')
    
    # Called when it is this bot's turn to play.
    def think(self, G, ctx):
        cells = G['cells']
        idx = -1
        while True and None in cells:
            idx = random.randint(0, len(cells)-1)
            if not cells[idx]:
                break
        return self.make_move('clickCell', idx)

    # Called when game is over.
    def gameover(self, G, ctx):
        print 'winner is '+ctx['gameover']

[nicolodavis]

This is quite exciting @francoijs! Will take a look in the next couple of days.

[nicolodavis]

Looks good @francoijs! Do you want to send me a PR to merge it in this repo? Just keep it in a directory called python at the root level.

One comment:
You should look at actionPlayers and not currentPlayer to determine if it is the bot's turn to play.

[francoijs]

Here it is: #195

[nicolodavis]

I just realized that for bots to be useful, they need some mechanism to simulate future moves. Do you have any thoughts on how we might do this for Python bots, given that the game engine is in JavaScript?

[jstacoder]

If you need to call functions from the engine in python you can use PyExecJs, which gives you access to the js runtime, so you can call JavaScript functions and return the results to the calling python code.