Instructions

If you don't know Python, go here

How to use StixAI:

1. Place the Stixai.pyc into the same folder as your project OR in your python27 Lib folder, which will generally be in Windows C: drive on a PC. On a Mac, I'm not sure as I don't use one for programming, but the Lib folder should (hopefully) be the same.
2. Create a python project
3. On the first line of code, write import Stixai
4. Create a variable (which I will refer to as "aivar") with the value: Stixai.ai(inputs, outputs). inputs and outputs are lists containing the robot actions and player responses, and they can be written however you want, provided that both inputs and outputs use the same syntax, such as "attack" and "defend", "h1f3" and "h2f2", or something to that effect. These lists must be handled by your own code, and must be the same length to avoid errors.
5. Get a player action and feed it into the function aivar.get_act(<player action>, valres), where valres is the number of times this function has been called because it gave an invalid action due to the game circumstances. If no action will ever be against the game's rules, then just set valres to 0 and leave it at that. This will return a value, which you can use in your code. The value will either be the most common response to the situation, or a random response if the situation is unknown.
6. Handle inputs and outputs by adding robot output to inputs and adding player input to outputs.

Questions? Just ask Matteo Harris at the Maker Fair, or email me at matteovh@gmail.com.