Skip to main content

Emma

Emma is the experimental little sister of Otto, and she is to help you interact with Infrahub.

Currently, Emma can help you to:

  • Import CSV Data into Infrahub
  • Export Data from Infrahub in CSV format
  • Build, Load, and Visualize the Infrahub schema
warning

Emma is experimental by design, and may not work as expected. She tests out new ideas before her big brother Otto gets involved and implements them in Infrahub.

Emma Homepage

Getting started​

curl quickstart​

This command will use the Infrahub Quickstart method to download a Docker Compose file and start Infrahub and Emma.

note

The Infrahub version number in the URL should be updated to the latest version.

curl https://infrahub.opsmill.io/1.1.6-emma | docker compose -f - up -d

Then connect to the WebUI of Infrahub and Emma

Running locally with poetry​

To run Emma locally using Poetry, follow these steps:

  1. Clone the Emma repository
git clone https://github.com/opsmill/emma.git
  1. Install Dependencies:
cd emma
poetry install
  1. Run the Application:
poetry run streamlit run main.py
  1. Set Environment Variables:

Emma uses Infrahub standard environment variables to connect to Infrahub:

export INFRAHUB_ADDRESS="http://localhost:8000"
export INFRAHUB_API_TOKEN="06438eb2-8019-4776-878c-0941b1f1d1ec"

Running with Docker Compose​

To run Emma using Docker Compose, follow these steps:

  1. Clone the Emma repository
git clone https://github.com/opsmill/emma.git
  1. Build and Run the Application:
cd emma
docker compose up --build &
  1. Connecting to Infrahub Network:

If you run Infrahub as another container in the local network, you need to connect Emma to it. After starting both containers, run the following command:

docker network connect <infrahub-network> emma-emma-1