AlphAI – Known issues

Problems related to the AlphAI software

  • If the software launch is very slow or seems blocked, but the console does not display any error message, it is likely due to a lack of available RAM on your computer. Try to close a few other applications to free some memory, and the AlphAI launch should resume normally.
  • AlphAI contains a bug in versions 1.7.3 to 1.7.22, that can cause the software to quit unexpectedly when refusing to perform an update. If you encounter this problem, it is recommended that you simply update the software. However, if you cannot or do not want to perform this update, you can solve the issue by following these steps. First, download the file Start_Alphai.pyc. Then, move it to the AlphAI folder where it should replace the existing file with the same name. If you do not know where to find your AlphAI folder, you can right-click the AlphAI icon on your desktop and select open target folder.

Software issues on macOS

  • Bluetooth connection with macOS require AlphAI version 1.8.0 or above.
  • When launching AlphAI from a terminal with the command alphai, you might encounter the following error message: PermissionError: [Errno 2] Operation not permitted. In this case, you should close the terminal, go to System Preferences > Security & Privacy > Privacy – Select Full Disk Access, and allow disk access for the Terminal application. Then, you can re-open a terminal and execute the command alphai.
  • My Thymio robot is detected by Thymio Suite, but there is no connection button in AlphAI. -> You need to update the library tdmclient. Simply open a terminal and execute the command: ~/Documents/AlphAI/alphaienv/bin/python3 -m pip install --upgrade tdmclient (this requires an internet connection). Then, restart AlphAI.

Issues with AlphaBots

  • My robot blinks with a white color and has number 0. -> You need to reconfigure the robot. You can follow the instructions at SD card configuration.
  • My robot does not blink after I turn it ON and wait 30 seconds. -> Please follow these steps:
    1. Remove the robot’s shell and check whether the red PWR diode next to the batteries lights up continuously. If not, the batteries need to be charged.
    2. From the connection screen in the AlphAI software, click on the Troubleshooting button and follow the instructions.