The ACRE Repository Manager is a GUI tool to manage a repository of ACRE Protocols. It allows you to create, edit and view local repositories but also to browse remote repositories via HTTP.

Running the Repository Manager

If you wish to be able to view graphical diagrams of the protocols in a repository, you must firstly installGraphviz (specifically, the ‘dot’ executable must be in your path).

The latest version of the Repository Manager can be found here. After downloading the JAR file, double-clicking on it should run the Repository Manager.

Please report bugs to the ASTRA Bug Forum.

Installing Graphviz

  • Windows: Download graphviz from here. The latest .msi package is recommended. After installation, you may need to log in to Windows again before it can be seen.
  • Mac OSX: Graphviz packages for OSX are also available from the Graphviz download page.
  • Debian/Ubuntu Linux: Run the following command as root: apt-get install graphviz
  • Fedora Linux: Run the following command as root: yum install graphviz
  • Others: Your package manager may also have a graphviz package. Alternatively, it can be downloaded from here.

Working with Remote Repositories

A remote repository is one located on a web server, meaning that it is accessible via HTTP. For remote repositories, the Repository Manager offers read-only access so that you may examine the protocols it provides before implementing them within your agents. Accessing a remote repository is done by selecting the Repository → Open Remote option from the menu (or using the Ctrl+R shortcut). This will prompt you for the URL of the repository (e.g.

Once a repository has been opened, all the protocol definitions it contains are visible in the Protocol Selector (see screenshot below). If this is too long, protocols can be filtered by namespace (using theNamespace Filter) or by name (using the Name Filter). Once you have selected the desired protocol, clicking the View button on the left will open a view of the protocol.

Working with Local Repositories

Local repositories are those located on the computer you are working on. These are read/write so the protocols they contain are editable. To create a new repository, choose the Repository → New option (or use the Ctrl+N shortcut). This will prompt you to choose a location for the repository. This should be an empty directory. If you have previously created a repository, open it using the Repository → Open Localoption (or use the Ctrl+L shortcut).

Once open, the protocols already in a repository are viewable and filterable in the same way as for a remote repository. However, for local repositories, the buttons on the left are available to make changes to the protocols in the repository. These are:

  • New: Create a new, empty, protocol and edit it with the Protocol Editor.
  • Edit: Make modifications to the protocol currently selected in the Protocol Selector. This also opens the Protocol Editor.
  • Import: Import a previously-created protocol definition into this repository. You must select a valid protocol definition (with a .acr) extension when prompted.
  • Delete: Delete the protocol currently selected in the Protocol Selector from the repository.