Jacamo-web is an interactive programming IDE based on JaCaMo, a Multi-Agent System (MAS) Oriented Programming platform. The interactive development allows making changes on instances of agents, artefacts and organisations, which means that the system can be updated while it is running.
$ git clone https://github.com/jacamo-lang/jacamo-web.git
$ cd jacamo-web
$ ./gradlew run
See http://yourIP:8080 for a web interface (see the console for the right IP:port). You can also try ./gradlew run --args="src/jcm/marcos.jcm"
, ./gradlew run --args="src/jcm/bob.jcm"
, and go to /examples
for more sample projects and information about how to run them.
If you want to make changes to the jacamo-web front end, install Node.js and install the webpack client with yarn install -g webpack client
.
Then, install the jacamo-web front end dependencies by running yarn install
in the project's root repository.
Run the webpack watch task with yarn run watch
. All changes you make to JavaScript files will be automatically built and deployed to your local jacamo-web instance.
You can create a local docker image of jacamo-web. First, make sure you are in the jacamo-web
root folder, then run the following command (super user privileges may be necessary):
jacamo-web$ docker build -t jacamo-web:0.5 .
It will take some minutes to build the docker image. After finishing, the jacamo-web image should be listed by the command docker image ls
. Execute the following command to launch a container based on jacamo-web docker image:
$ docker run -it --name jacamo-web jacamo-web:0.5
In the log you should see a message similar to "jacamo-web Rest API is running on http://yourIP:8080/" (e.g. http://172.17.0.2:8080/), so you can open your browser on the referred URL.
To rerun jacamo-web
after stopping the container execute:
$ docker container start -i jacamo-web
Alternativelly, you can remove the pre-generated jacamo-web
container executing docker container rm jacamo-web
.
It uses jacamo-rest on the back-end and provides a web front-end developed in plain javascript, the API jacamo-rest 0.3 bind these parts.
In short, jacao-web provides an interface to develop Multi-Agent Systems interactively allow to send beliefs and plans to agents, inspect, create and destroy them. It is also supported dynamic compiling of CArtAgO artefacts and Moise organisations. The following diagram shows the main functionalities of the interface: