Start the Core AI Engine¶

This tutorial shows how to start the Core AI Engine that will orchestrate the services and the pipelines.

Introduction¶

This tutorial shows how to start the Core AI Engine.

Prerequisites¶

To follow this tutorial, we highly recommend you to follow the Getting started guide first.

It contains all the required tools to follow this tutorial.

Start the Core AI Engine locally¶

Clone the Core AI Engine repository¶

Clone the Core AI Engine repository with the following command.

1
2

# Clone the Core AI Engine repository
git clone [email protected]:swiss-ai-center/core-engine

Start the Core AI Engine locally with Docker Compose¶

In the core-engine/backend directory, start the Core AI Engine Backend with the following commands:

1
2
3
4
5

# Build the Docker image
docker compose build

# Start the Core AI Engine Backend
docker compose up

Access the Core AI Engine Backend documentation at http://localhost:8080/docs.

In the core-engine/frontend directory, start the Core AI Engine Frontend with the following commands:

1
2
3
4
5

# Build the Docker image
docker compose build

# Start the Core AI Engine Frontend
docker compose up

Access the Core AI Engine Frontend on http://localhost:3000.

Start a dummy service to test the Core AI Engine locally¶

Clone the dummy service repository¶

average-shade-service is a very simple service that can be used to test the Core AI Engine locally.

Clone the average-shade-service repository with the following command.

1
2

# Clone the average-shade-service repository
git clone https://github.com/swiss-ai-center/average-shade-service

Start the service locally with Docker Compose¶

In the average-shade-service directory, start the service with the following commands:

1
2
3
4
5

# Build the Docker image
docker compose build

# Start the service
docker compose up

Access the service documentation at http://localhost:9090/docs.

Try out the Core AI Engine with the dummy service¶

Access the Core AI Engine on http://localhost:3000 or http://localhost:8080/docs to validate the service has been successfully registered to the Core AI Engine.

Try out the service by uploading an image and clicking on the Run button.

It should return the average shade of the image.

Conclusion¶

Congratulations! You have successfully started the Core AI Engine and a dummy service to try out the features of the Core AI Engine.

Go further¶

Follow the official tutorials by following the Getting started guide.