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.

Straightforward deploying to Heroku

Fork this repository
Go to heroku website, create an app giving any name to it
On Deploy -> Deployment method choose github
find your fork of 'jacamo-web'
'Deploy branch'

Running locally

Using a local gradle

$ 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.

Making front end changes

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.

Using a local docker

$ docker build  -t jacamo-runrest .
$ docker network create jcm_net
$ docker run -ti --rm --net jcm_net  --name host1 -v "$(pwd)":/app jacamo-runrest gradle marcos
$ docker run -ti --rm --net jcm_net  --name host2 -v "$(pwd)":/app jacamo-runrest gradle bob_d

These commands build a docker image and launch marcos and bob projects. Usually super user privileges are necessary.

Deploying from local repository to Heroku

After installing the Heroku Toolbelt you can test the app locally using heroku CLI:

$ ./gradlew stage
$ heroku local web

Your app should now be running on localhost:5000.

Deploying from local repository

$ heroku create
$ git push heroku master
$ heroku open

More about 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:

Interactive programming concept with jacamo-web

programmingconcept digraph G { graph [ rankdir="RL" ] subgraph cluster_1 { label="Environment: CArtAgO"; Artifact [shape = record, label="Artifact"]; ArtInsp [shape = plain, label="Artifact Inspection"]; ArtEdit [shape = plain, label="Edit artifact code"]; ArtCreate [shape = plain, label="Make new artifact"]; ArtDispo [shape = plain, label="Dispose artifact"]; } subgraph cluster_0 { label="Agents: Jason"; Agent [label="Agent"]; AgInsp [shape = plain, label="Agent Inspection"]; AgCmd [shape = plain, label="Send commands"]; AgEdit [shape = plain, label="Edit Agent"]; AgCreate [shape = plain, label="Create agent"]; AgKill [shape = plain, label="Kill agents"]; AgDF [shape = plain, label="Directory Facilitator"]; } subgraph cluster_2 { label="Organisation: Moise"; Org [shape = tab, label="Organisation"]; OrgInsp [shape = plain, label="Organisation Inspection"]; OrgEdit [shape = plain, label="Edit organisation"]; OrgAgR [shape = plain, label="Adopting role"]; OrgAgM [shape = plain, label="Commiting mission"]; } AgInsp -> Agent [color = gray20, fontcolor = gray20, style = dotted]; AgCmd -> Agent [color = gray20, fontcolor = gray20, style = dotted]; AgEdit -> Agent [color = gray20, fontcolor = gray20, style = dotted]; AgCreate -> Agent [color = gray20, fontcolor = gray20, style = dotted]; AgKill -> Agent [color = gray20, fontcolor = gray20, style = dotted]; AgDF -> Agent [color = gray20, fontcolor = gray20, style = dotted]; ArtInsp -> Artifact [color = gray20, fontcolor = gray20, style = dotted]; ArtEdit -> Artifact [color = gray20, fontcolor = gray20, style = dotted]; ArtCreate -> Artifact [color = gray20, fontcolor = gray20, style = dotted]; ArtDispo -> Artifact [color = gray20, fontcolor = gray20, style = dotted]; OrgInsp -> Org [color = gray20, fontcolor = gray20, style = dotted]; OrgEdit -> Org [color = gray20, fontcolor = gray20, style = dotted]; OrgAgR -> Org [color = gray20, fontcolor = gray20, style = dotted]; OrgAgM -> Org [color = gray20, fontcolor = gray20, style = dotted]; } programmingconcept

esteban-g / jacamo-web