An extensible Python framework for simulating and interacting with robots
Project description
Soar
Soar (Snakes on a Robot) is a Python framework for simulating and interacting with robots.
The software is designed to be the following:
painless: Using Soar for its intended purpose should be trivial. A student using Soar as part of an intro robotics course should, in the ideal case, have to look at Getting Started and nothing else.
extensible: Soar can support nearly any type of robot and any type of connection, so long as the user provides a suitable interface. Connect to robot’s over a serial port, WiFi, Bluetooth, etc–Soar is interface-agnostic. Though Soar provides basic physics for 2D collision detection and movement, the physics of simulated worlds and objects can be completely overidden.
simulation-driven: The most typical use case of Soar will be to run some stepwise simulation on a certain robot type, with some brain controlling it. It is not primarily designed for persistent robots that are always on or for situations where stepwise interaction is not suitable.
multiplatform: Soar uses no platform specific features, and uses Python’s standard GUI package, Tkinter, for its GUI. Soar should thus work on any platform with a standard Python interpreter of version 3.5 or later.
open source: Soar is licensed under the LGPLv3, and may be used as a library by projects with other licenses.
To get started using Soar, see the Getting Started or the documentation.
Installation
Installing Soar is (hopefully) painless and primarily done 3 ways, ordered by decreasing ease:
From PyPI
Soar can be installed from the Python Package Index (PyPI) by running pip install soar.
This will install the latest stable (not development) release.
From Releases
An arbitrary stable (not development) Soar release can be installed from the github releases, by downloading the .zip archive and running pip install <path-to-zip>.
From latest source
Clone or download the git repo, navigate to the directory, then run:
python3 setup.py sdist cd dist pip install Soar-<version>.tar.gz
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
