Skip to content

SpielViz is an interactive viewer for OpenSpiel games.

License

Notifications You must be signed in to change notification settings

michalsustr/spielviz

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SpielViz

SpielViz is an interactive viewer for OpenSpiel games.

It is based on xdot.py, a GraphViz's viewer in Python.

Beware that you might not be able to display some games with large branching factor and tree lookahead (like Go).

Screenshot of SpielViz on the game of kuhn_poker(players=4)

Run as:

pip install -e .
python -m spielviz

TODOs

PRs are welcome! Feel free to open an issue and state you'd like to contribute. I will be working on this project probably very sporadically.

  • Make a warning when building a large graph, show only a subset.
  • Show information about the pyspiel.Game.
  • Use customizable Observer to show observations in the games.
  • Use keyboard to move withing the Graph (acejump-style).
  • Add custom game views (state view components) -- down_class python bindings for specific games.
  • Show mapping to public / private trees.
  • Create a CLI interface that jumps to specific positions in games.
  • Add a GUI history.
  • Add a game transformation to OpenSpiel that acts as an action factorization so that we can show games with large branching factor nicely.
  • Add game parameter autocompletion.
  • Make graph presentation more nice -- label sizes, edge expansion location, colors, shapes, highlights, etc.
  • Add support for bots, showing probabilities of movements / other stats.
  • Create a snap package and publish in Ubuntu repo.

Features

  • Arbitrary loading of games (and game transformations).
  • Jump to specific history.
  • Shows detailed information about pyspiel.State.
  • Since it doesn't use bitmaps it is fast and has a small memory footprint.
  • Arbitrary zoom.
  • Keyboard/mouse navigation.
  • Highlights node/edge under mouse.

Install

See INSTALL.md for details.

Versioning

We use Semantic Versioning, but no version has been released yet - the code is under pure development phase for now.

About

SpielViz is an interactive viewer for OpenSpiel games.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published