Go back

Setup and installation of 'Open Notebook - The AI Podcast creator' on GCP

This section describes how to provision and connect to ‘Open Notebook - The AI Podcast creator’ VM solution on GCP.

  1. Open Open Notebook - The AI Podcast creator listing on GCP Marketplace.

  2. Click Get Started.

/img/gcp/open-notebook/marketplace.png

It will ask you to enable the API’s if they are not enabled already for your account. Please click on enable as shown in the screenshot.

/img/gcp/nvidia-ubuntu/enable-api.png

  • It will take you to the agreement page. On this page, you can change the project from the project selector on top navigator bar as shown in the below screenshot.

  • Accept the Terms and agreements by ticking the checkbox and clicking on the AGREE button. /img/common/gcp_agreement_page.png

  • It will show you the successfully agreed popup page. Click on Deploy. /img/common/gcp_agreement_accept_page.png

  • On deployment page, give a name to your deployment.

  • In Deployment Service Account section, click on Existing radio button and Choose a service account from the Select a Service Account dropdown.
  • If you don't see any service account in dropdown, then change the radio button to New Account and create the new service account here.
  • If after selecting New Account option, you get below permission error message then please reach out to your GCP admin to create service account by following Step by step guide to create GCP Service Account and then refresh this deployment page once the service account is created, it should be available in the dropdown.

  • You are missing resourcemanager.projects.setIamPolicy permission, which is needed to set the required roles on the created Service Account
  • Select a zone where you want to launch the VM(such as us-east1-a)

  • Optionally change the number of cores and amount of memory.

Minimum VM Specs : 15GB RAM /4vCPU

/img/gcp/open-notebook/cpu-instance.png

  • Optionally change the boot disk type and size. (This defaults to ‘Standard Persistent Disk’ and 50GB respectively)

  • Optionally change the network name and subnetwork names. Be sure that whichever network you specify has ports 22 (for ssh), 3389 (for RDP), 80 (for HTTP) and 443 (for HTTPS) exposed.

  • Click Deploy when you are done.

  • Open Notebook - The AI Podcast creator will begin deploying.

/img/gcp/open-notebook/deployed-01.png

/img/gcp/open-notebook/deployed-02.png

/img/gcp/open-notebook/deployed-02.png

  1. A summary page displays when the compute engine is successfully deployed. Click on the Instance link to go to the instance page .

  2. On the instance page, click on the “SSH” button, select “Open in browser window”.

/img/gcp/puppet-support/ssh-option.png

  1. This will open SSH window in a browser. Switch to ubuntu user and navigate to ubuntu home directory.
sudo su ubuntu
cd /home/ubuntu/

/img/gcp/open-notebook/switch-user.png

  1. Run below command to set the password for “ubuntu” user
sudo passwd ubuntu

/img/gcp/open-notebook/update-passwd.png

  1. Now the password for ubuntu user is set, you can connect to the VM’s desktop environment from any local windows machine using RDP or linux machine using Remmina.

  2. To connect using RDP via Windows machine, first note the external IP of the VM from VM details page as highlighted below

/img/gcp/open-notebook/public-ip.png

  1. Then From your local windows machine, goto “start” menu, in the search box type and select “Remote desktop connection”

  2. In the “Remote Desktop connection” wizard, paste the external ip and click connect

/img/gcp/jupyter-python-notebook/rdp.png

  1. This will connect you to the VM’s desktop environment. Provide “ubuntu” as the userid and the password set in step 6 to authenticate. Click OK

/img/gcp/jupyter-python-notebook/rdp-login.png

  1. Now you are connected to out of box Open Notebook - The AI Podcast creator VM’s desktop environment via Windows machines.

/img/azure/minikube/rdp-desktop.png

  1. To connect using RDP via Linux machine, first note the external IP of the VM from VM details page, then from your local Linux machine, goto menu, in the search box type and select “Remmina”.

Note: If you don’t have Remmina installed on your Linux machine, first Install Remmina as per your linux distribution.

/img/gcp/common/remmina-search.png

  1. In the “Remmina Remote Desktop Client” wizard, select the RDP option from dropdown and paste the external ip and click enter.

/img/gcp/common/remmina-external-ip.png

  1. This will connect you to the VM’s desktop environment. Provide “ubuntu” as the userid and the password set in step 6 to authenticate. Click OK

/img/gcp/common/remmina-rdp-login.png

  1. Now you are connected to out of box Open Notebook - The AI Podcast creator VM’s desktop environment via Linux machine.

/img/azure/minikube/rdp-desktop.png

  1. The VM will generate a random password to login to Open Notebook Web Interface as well as an encryption key for database access. To get the password, connect via SSH terminal as shown in above steps and run below command.
cat /home/ubuntu/open-notebook-local/open_notebook_credentials.txt

/img/azure/open-notebook/open-notebook-passwd.png

  1. To access the Open Notebook Web Interface, copy the public IP address of the VM and paste it in your local browser as https://public_ip_of_vm.

Browser will display an SSL certificate warning message. Expand the warning message, accept the certificate warning and Continue.

/img/azure/open-notebook/browser-warning.png

  1. It will open a login page. Provide the password we got at step 14 above and click Sign In.

/img/azure/open-notebook/login-with-passwd.png

  1. Now you are logged in to Open Notebook Web Interface.

/img/azure/open-notebook/open-notebook-web-interface.png

Note: If you encounter API Connection Error as shown in the below screenshot then please reboot the vm and access the Web Interface at https://public_ip_of_vm.

/img/gcp/open-notebook/connection-error.png

  1. The VM comes with “Ollama setup” and few models are already pulled for you to get started. To begin with the Open Notebook, first you need to configure the ollama models. To do so, Click on Models option from left menu and scroll down to Ollama section. Click on Add Configuration button.

/img/azure/open-notebook/ollama-configuration.png

  1. Give a name to your configuration, leave API Key blank, for Base URL enter http://ollama:11434 . As the ollama is running in container make sure to enter Base URL as http://ollama:11434 and not http://localhost:11434.

/img/azure/open-notebook/add-configuration.png

  1. Scroll up and you should see ollama successfully configured. Now next we need to add language and embedding models. For that click on models option as shown in the below screenshot.

/img/azure/open-notebook/ollama-configured.png

  1. Select Model Type as Language. By default following ollama models are already pulled on this VM. Select language model(s) from the list of available models.

/img/azure/open-notebook/add-language-model.png

  1. Selected models will get added as shown below. Similarly again click on models option to add embedding models. Select Model Type as Embedding and tick mxbai-embed-large:latest from the list of available models.

/img/azure/open-notebook/ollama-language-models-added.png

/img/azure/open-notebook/add-ollama-embedding-model.png

Note: If you want to go with other LLM providers like OpenAI/Anthropic etc, then configure the same from this Models page.

  1. Now we configured the ollama models, we need to set the default models. On the same Models page, scroll up to the top to Default Model Assignments section. Select various models from the dropdown.

/img/azure/open-notebook/set-default-models.png

  1. Now you are all set to use Open Notebook. The basic workflow include, creating a new notebook with a detailed description (as detailed description helps LLM to understand the context of the notebook and provide you with better answers), add sources , gather insights from the added sources using transformations and finally talk to Assistant.

/img/azure/open-notebook/add-notebook.png

  1. To add the sources, click on New from left menu and select Sources option. Choose from various options.

/img/azure/open-notebook/add-sources.png

/img/azure/open-notebook/add-sources-02.png

Click on Next to select the Notebook for this sources.

/img/azure/open-notebook/select-notebook-for-the-source.png

Click on Next and lastly select the Transformation option.

/img/azure/open-notebook/transformation.png

You can see the list of added sources here.

/img/azure/open-notebook/sources-added.png

  1. Once your sources are ready, you can use notebook, Ask and Search and Podcast features.

/img/azure/open-notebook/use-notebook-feature.png

  1. For Podcast feature, you will need some extra configuration. you will need to update the podcast profiles and need to provide the various models including voice. Once it is ready, go to podcast tab from left pane, clik on Generate podcast and provide the details here. For more details please refer to official documentation here

/img/azure/open-notebook/podcast.png

/img/azure/open-notebook/podcast-profile.png

  1. Lastly, to pull more ollama models on this VM, connect via SSH terminal and run below command.
sudo docker exec open-notebook-local-ollama-1 ollama pull <modelname>

e.g sudo docker exec open-notebook-local-ollama-1 ollama pull qwen2.5:latest

/img/azure/open-notebook/pull-ollama-models.png

/img/azure/open-notebook/list-ollama-models.png

For more details, please visit Official Documentation page

Go back