Run with local message bus

Blueapi can publish updates to a message bus asynchronously, the CLI can then view these updates display them to the user.

Start RabbitMQ

The worker requires a running instance of RabbitMQ. The easiest way to start it is to compose the services in tests/system_tests/compose.yaml

docker compose -f tests/system_tests/compose.yaml run rabbitmq --detach

Config File

Create a YAML file for configuring blueapi:

# stomp.yaml

# Edit this if your message bus of choice is running on a different host,
# if it has different credentials,
# or if its STOMP plugin is running on a different port
stomp:
  enabled: true # All other stomp settings will be ignored if this is false
  url: tcp://localhost:61613
  auth:
    username: guest
    password: guest

Run the Server

blueapi --config /path/to/stomp.yaml serve

The server should print a connection message to the console. If there is an error, it will print an error message instead. When checking out the repository, there is an example STOMP config present in src/script/stomp_config.yml