Skip to main content

Develop your robotic tasks with hierarchical state machines using an intuitive graphical user interface

Project description

Screenshot showing RAFCON with a big state machine

Develop your robotic tasks using an intuitive graphical user interface

RAFCON uses hierarchical state machines, featuring concurrent state execution, to represent robot programs. It ships with a graphical user interface supporting the creation of state machines and contains IDE like debugging mechanisms. Alternatively, state machines can programmatically be generated using RAFCON’s API.

Universal application

RAFCON is written in Python, can be extended with plugins and is hard- and middleware independent.

Visual programming

The sophisticated graphical editor can be used for the creation, execution and debugging of state machines.

Collaborative working

Share and reuse your state machines in form of libraries, stored as JSON strings in text files.

Example on how to create a simple state machine

Installation preparations

Before installing RAFCON, Python >=3.7, pip and setuptools are required on your system. Most of the other dependencies are automatically resolved by pip/setuptools, but not all of them. Those need be be installed manually, too:

Installation requirements

sudo apt-get install python-dev python-pip build-essential glade python-gi-cairo
sudo -H pip install --upgrade pip
sudo -H pip install --upgrade setuptools

General requirements

  • Python >=3.7

  • pip (recent version required: v23 known to be working)

  • pdm (recent version required: v2.9.3 known to be working)

Installing RAFCON

pip install rafcon --user

The --user flag is optional. If not set, RAFCON is installed globally (in this case you normaly need to have root privileges).

If during the installation the error ImportError: No module named cairo occurs, please install pycairo directly via:

pip install --user "pycairo==1.19.1"

Of course you can also directly use the RAFCON sources from GitHub.

cd /install/directory
git clone https://github.com/DLR-RM/RAFCON rafcon

Start RAFCON

No matter which installation option you choose, RAFCON can be started from any location using (make sure /usr/local/bin or ~/.local/bin is in your PATH environment variable):

rafcon

On a multi-python setup start rafcon using:

python<your-version> -m rafcon

Uninstallation

If you want to uninstall RAFCON, all you need to do is call

pip uninstall rafcon

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rafcon-2.1.4.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

rafcon-2.1.4-py3-none-any.whl (2.9 MB view details)

Uploaded Python 3

File details

Details for the file rafcon-2.1.4.tar.gz.

File metadata

  • Download URL: rafcon-2.1.4.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.13

File hashes

Hashes for rafcon-2.1.4.tar.gz
Algorithm Hash digest
SHA256 a519e98264084b52063f49fe8535b6532df2019611e79909cd9863a4414c298b
MD5 e696966de1e1499573708f9838bfedc6
BLAKE2b-256 ca055dc061cec3064774a5307d0e366c882033a3f0e9adc157a6ba931a7ecf93

See more details on using hashes here.

File details

Details for the file rafcon-2.1.4-py3-none-any.whl.

File metadata

  • Download URL: rafcon-2.1.4-py3-none-any.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.13

File hashes

Hashes for rafcon-2.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 151b2bd508457ebb031545e3c228e05895e67042aa6cf937763229fe3d1170f1
MD5 e72ed39dab4c2a38fb4da8918ee16566
BLAKE2b-256 3da1337ce105e2de58e51f303fbafd9fb3738f34b136df3535144f3d1334a3ee

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page