Install and Launch NeMo Studio#

Choose one of the following methods to install NeMo Studio:

  • Installing NeMo Studio on a Minikube Cluster: For testing and pre-production environments. If you are a developer and want to try NeMo Studio along with the NeMo microservices platform on a minikube cluster, choose this option.

  • Installing NeMo Studio on a Kubernetes Cluster: For production environments. If you are a platform architect and want to deploy NeMo Studio along with the NeMo microservices platform on a production-grade Kubernetes cluster, choose this option.

Installing NeMo Studio on a Minikube Cluster#

If you want to try NeMo Studio on a minikube cluster for testing and pre-production environments, follow these steps:

  1. Set up the minikube cluster by following the instructions in Set Up Manually.

  2. When you reach the Helm install command step, add the tags.studio set to true to the command as follows:

    $ helm --namespace default install \
    nemo nmp/nemo-microservices-helm-chart \
    --set guardrails.guardrails.nvcfAPIKeySecretName="nvidia-api"
    --set tags.studio=true

  3. Verify that your ingress controller is configured with the CORS annotations, the NeMo Studio service path, and the default values for platformBaseUrl, dataStoreUrl, and nimProxyUrl.

    $ kubectl get ingress nemo-microservices-helm-chart -o yaml | grep cors
$ kubectl get ingress nemo-microservices-helm-chart -o jsonpath='{.spec.rules[*].http.paths[*].path}' | grep studio
$ kubectl describe pod -l app.kubernetes.io/name=studio

  4. On your local machine, edit the /etc/hosts file to include the following host aliases:

    $ echo -e "127.0.0.1 nemo.test\n127.0.0.1 data-store.test\n127.0.0.1 nim.test" | sudo tee -a /etc/hosts

  5. Choose one of the following options to make Studio accessible from your local machine:

    • Option 1: If you have access to the Kubernetes cluster, follow these steps to set up port-forwarding to your ingress controller.

      • On your local machine, run the following command to forward traffic to the ingress controller:

        $ kubectl port-forward -n ingress-nginx service/ingress-nginx-controller 3000:80

        Note

        If your cluster is running inside a container, you may need to set up an additional port-forwarding step to create a complete forwarding chain from your local machine through the container to the cluster.

    • Option 2: If you have SSH access to your cluster, follow these steps to create an SSH tunnel between your local machine and the remote machine.

      • On your local machine, run the following command to create an SSH tunnel. Replace <user@minikube-ip> with the username and IP address of your minikube cluster:

        $ ssh -L 3000:nemo.test:80 <user@minikube-ip>

  6. Open http://nemo.test:3000/studio in your browser. This opens the Projects page by default. If you already have created projects, the projects and created resources within each project are displayed. If not, it prompts you to create a new project. Proceed to NeMo Studio Feature Overview to start exploring the features in the NeMo Studio UI.

Installing NeMo Studio on a Kubernetes Cluster#

To deploy NeMo Studio along with the NeMo microservices platform on a production-grade Kubernetes cluster, follow the instructions in Deploy NeMo Studio Using Parent Helm Chart.

If you are a platform architect, you are responsible for configuring the ingress and port-forwarding to access the NeMo Studio URL. If you are a developer, consult your platform architect for assistance.