{"id":13704035,"url":"https://github.com/DLR-RM/RAFCON","last_synced_at":"2025-05-05T09:33:03.310Z","repository":{"id":18001131,"uuid":"83153618","full_name":"DLR-RM/RAFCON","owner":"DLR-RM","description":"RAFCON (RMC advanced flow control) 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.","archived":false,"fork":false,"pushed_at":"2024-10-24T09:41:25.000Z","size":114183,"stargazers_count":181,"open_issues_count":157,"forks_count":35,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-10-25T07:28:44.306Z","etag":null,"topics":["graphical-programming","robotics","state-machine"],"latest_commit_sha":null,"homepage":"https://dlr-rm.github.io/RAFCON/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DLR-RM.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.rst","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-25T18:39:02.000Z","updated_at":"2024-09-26T20:18:02.000Z","dependencies_parsed_at":"2024-02-26T16:27:16.436Z","dependency_job_id":"20a8d00f-3011-486c-9c14-e14e4b331625","html_url":"https://github.com/DLR-RM/RAFCON","commit_stats":{"total_commits":7853,"total_committers":26,"mean_commits":"302.03846153846155","dds":0.5767222717432828,"last_synced_commit":"608c481197e2de9f8d1f1afbe7788f7afd1b538d"},"previous_names":[],"tags_count":136,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLR-RM%2FRAFCON","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLR-RM%2FRAFCON/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLR-RM%2FRAFCON/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DLR-RM%2FRAFCON/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DLR-RM","download_url":"https://codeload.github.com/DLR-RM/RAFCON/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224439725,"owners_count":17311512,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graphical-programming","robotics","state-machine"],"created_at":"2024-08-02T21:01:03.306Z","updated_at":"2025-05-05T09:33:03.300Z","avatar_url":"https://github.com/DLR-RM.png","language":"Python","funding_links":[],"categories":["Behavior and Decision","Libraries"],"sub_categories":["Vector Map","SLAM","Python"],"readme":"\nRAFCON\n======\n\n.. figure:: documents/assets/Screenshot_Drill_Skill_Scaled.png\n   :figwidth: 100%\n   :width: 800px\n   :align: left\n   :alt: Screenshot showing RAFCON with a big state machine\n   :target: documents/assets/Screenshot_Drill_Skill_Scaled.png?raw=true\n\n* Documentation: Hosted on `Read the Docs \u003chttp://rafcon.readthedocs.io/en/latest/\u003e`_\n* Homepage: `DLR-RM.github.io/RAFCON/ \u003chttps://dlr-rm.github.io/RAFCON/\u003e`_\n* License: `EPL \u003chttps://github.com/DLR-RM/RAFCON/blob/master/LICENSE\u003e`_\n* Cheatsheet: `Download Cheatsheet \u003cdoc/_static/rafcon_cheatsheet.pdf\u003e`_\n\nDevelop your robotic tasks using an intuitive graphical user interface\n----------------------------------------------------------------------\n\nRAFCON uses hierarchical state machines, featuring concurrent state execution, to represent robot programs.\nIt ships with a graphical user interface supporting the creation of state machines and\ncontains IDE like debugging mechanisms. Alternatively, state machines can programmatically be generated\nusing RAFCON's API.\n\nUniversal application\n\n  RAFCON is written in Python, can be extended with plugins and is hard- and middleware independent.\n\nVisual programming\n\n  The sophisticated graphical editor can be used for the creation, execution and debugging of state machines.\n\nCollaborative working\n\n  Share and reuse your state machines in form of libraries, stored as JSON strings in text files.\n\n.. figure:: https://raw.githubusercontent.com/DLR-RM/RAFCON/master/documents/assets/RAFCON-sm-creation-preview.gif\n   :figwidth: 100%\n   :width: 570px\n   :align: left\n   :alt: Example on how to create a simple state machine\n\n\nInstallation preparations\n-------------------------\n\nBefore installing RAFCON, Python \u003e=3.7, pip and setuptools are required on your system. Most of the other dependencies\nare automatically resolved by pip/setuptools, but not all of them. Those need be be installed manually, too:\n\nInstallation requirements\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. code-block:: bash\n\n   sudo apt-get install python-dev python-pip build-essential glade python-gi-cairo\n   sudo -H pip install --upgrade pip\n   sudo -H pip install --upgrade setuptools\n\nGeneral requirements\n^^^^^^^^^^^^^^^^^^^^\n\n* Python \u003e=3.7\n* pip (recent version required: v23 known to be working)\n* pdm (recent version required: v2.9.3 known to be working)\n\n\nInstalling RAFCON\n-----------------\n\n.. code-block:: bash\n\n   pip install rafcon --user\n\nThe ``--user`` flag is optional. If not set, RAFCON is installed globally (in this case you normaly need to have root privileges).\n\nIf during the installation the error ``ImportError: No module named cairo`` occurs, please install pycairo directly\nvia:\n\n.. code-block:: bash\n\n   pip install --user \"pycairo==1.19.1\"\n\nOf course you can also directly use the RAFCON sources from GitHub.\n\n.. code-block:: bash\n\n   cd /install/directory\n   git clone https://github.com/DLR-RM/RAFCON rafcon\n\n\nStart RAFCON\n------------\n\nNo matter which installation option you choose, RAFCON can be started from any location using (make sure\n``/usr/local/bin`` or ``~/.local/bin`` is in your ``PATH`` environment variable):\n\n.. code-block:: bash\n\n   rafcon\n\nOn a multi-python setup start rafcon using:\n\n.. code-block:: bash\n\n   python\u003cyour-version\u003e -m rafcon\n\n\nUninstallation\n--------------\n\nIf you want to uninstall RAFCON, all you need to do is call\n\n.. code-block:: bash\n\n   pip uninstall rafcon\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDLR-RM%2FRAFCON","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDLR-RM%2FRAFCON","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDLR-RM%2FRAFCON/lists"}