pstlab/hermes_ai_server repository overview

⁠HERMES API

This image contains the AI-based representation and planning services developed within the Italian project HERMES⁠

⁠Source Repositories

Here are the references to the public source repositories linked to this image

• HERMES_ONTOLOGY⁠
• HERMES_API⁠

⁠Usage

To use the service inside the Docker image, run the following command to instantiate the container and map the port of the host machine to the port used by the service

docker run -p 8080:8080 -it --name hermes_api pstlab/hermes_ai_server:latest /bin/bash

Inside the container, there are two scripts you can use to install and run the service. The scripts are under the folder ~/bin.

• The script install_and_run_hairecompiles the Maven project, updating the jar file of the application. The script then runs the application and stores the log file inside ~/log/hermes_api.log
• The script run_hai simply runs the application using the jar file already available inside the container. It stores the log file inside ~/log/hermes_api.log

To run the application, check that all the requirements are fulfilled in the configuration files inside the container.

⁠Requirements

The service running inside the Docker container relies on the following requirements:

• Java 17 or newer, which is the baseline for Spring Boot 3.x
• A reachable MongoDB instance
  • NOTE: Check the file inside the container application.properties and replace the variables with a valid MONGODB USER, PASSWORD, and CLOUD
• Access to the HERMES RDF knowledge model file
• A PLATINUm installation or resource directory matching planner.platinum.home
  • NOTE: Check the Maven local settings inside the container (~/.m2/settings.xml) to add your GitHub token and be able to download the platinum package (check the pom dependency to the GitHub repository)