Skip to content

Commit d5f34fc

Browse files
author
ajosh0504
committed
Updating screenshots
1 parent 76d89a8 commit d5f34fc

File tree

7 files changed

+28
-27
lines changed

7 files changed

+28
-27
lines changed

docs/20-dev-env/1-dev-env-setup.mdx

Lines changed: 28 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -20,78 +20,79 @@ In this lab, we will be using Jupyter Notebooks, which is an interactive Python
2020

2121
## Option 1: GitHub Codespaces
2222

23-
You will be working in a Jupyter Notebook in a GitHub Codespace throughout this lab. A codespace is a cloud-hosted, containerized development environment that comes pre-configured with all the tools you need to run this lab.
23+
You will be working in GitHub Codespaces throughout this lab. A codespace is a cloud-hosted, containerized development environment that comes pre-configured with all the tools you need to run this lab.
2424

2525
Navigate to [this](https://github.com/codespaces/new/mongodb-developer/genai-devday-notebooks?quickstart=1) link. You will be prompted to sign into GitHub if you haven't already. Once signed in, click the **Create new codespace** button to create a new codespace.
2626

2727
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/3-create-codespace.png" alt="Start a codespace" />
2828

2929
Let it run for a few seconds as it prepares a Docker container with all the required libraries and a MongoDB cluster.
3030

31-
Once the environment is built, you should see a VS Code IDE with a list of files in the Explorer tab.
31+
### Connect to the MongoDB cluster
3232

33-
In the Explorer menu, under `notebooks`, click on the file named `ai-agents-lab.ipynb` to open the Jupyter Notebook for this lab.
33+
Once the environment is built, you will be prompted to connect to the MongoDB cluster via MongoDB's VSCode extension. This will allow you to visualize the data that we will import into the cluster later in the lab, directly from the VSCode IDE.
3434

35-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/2-nav-notebook.png" alt="Navigate to the notebook" />
35+
To connect to the cluster, click the **Connect** button.
3636

37-
Next, select the Python interpreter by clicking **Select Kernel** at the top right of the IDE.
37+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/4-click-connect.png" alt="Click Connect" />
3838

39-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/4-select-kernel.png" alt="Select kernel" />
39+
In the modal that appears at the top of the screen, enter the string `mongodb://admin:mongodb@mongodb:27017/` and hit `Enter` on your keyboard.
4040

41-
In the modal that appears, click **Python environments...** and select the interpreter that is marked as **Recommended** or **Global Env**.
41+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/5-enter-connection-string.png" alt="Enter connection string" />
4242

43-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/5-python-env-modal.png" alt="Select Python Environments" />
43+
If the connection was successful, you should see **Connected to: mongodb:27017** with a green indicator.
4444

45-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/6-select-recommended.png" alt="Select recommended interpreter" />
45+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/6-connection-successful.png" alt="Connection successful" />
4646

47-
That's it! You're ready for the lab!
47+
You can view the default and any additional collections we create on the cluster during the lab by clicking the leaf icon in the left navigation bar of the IDE.
4848

49-
<details>
50-
<summary>🦹 Use the MongoDB for VS Code extension to interact with the local MongoDB cluster from the VSCode IDE. </summary>
49+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/7-view-collections.png" alt="View collections" />
5150

52-
In the left navigation bar of the IDE, click on the leaf icon. Under Connections, click the **Add Connection** button.
51+
### Jupyter Notebook setup
5352

54-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/7-add-connection.png" alt="Add MongoDB connection" />
53+
You will be filling code in a Jupyter Notebook during this lab, so let's get set up with that next!
5554

56-
In the tab that appears, click the **Connect** button.
55+
Click on the files icon in the left navigation bar. In the Explorer menu, under `notebooks`, click on the file named `ai-agents-lab.ipynb` to open the Jupyter Notebook for this lab.
5756

58-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/8-click-connect.png" alt="Click Connect" />
57+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/8-nav-notebook.png" alt="Navigate to the notebook" />
5958

60-
In the modal that appears at the top of the screen, enter the string `mongodb://admin:mongodb@mongodb:27017/` and hit `Enter` on your keyboard.
59+
Next, select the Python interpreter by clicking **Select Kernel** at the top right of the IDE.
6160

62-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/9-enter-connection-string.png" alt="Enter connection string" />
61+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/9-select-kernel.png" alt="Select kernel" />
6362

64-
If the connection was successful, you should see the cluster and its default databases under Connections. Any additional databases and collections created during the lab will appear here as well.
63+
In the modal that appears, click **Python environments...** and select the interpreter that is marked as **Recommended** or **Global Env**.
6564

66-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/10-connections.png" alt="View connections" />
65+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/10-python-env-modal.png" alt="Select Python Environments" />
6766

68-
</details>
67+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/20-dev-env/1-dev-env-setup/11-select-recommended.png" alt="Select recommended interpreter" />
68+
69+
That's it! You're ready for the lab!
6970

7071
## Option 2: Run locally
7172

7273
:::caution
7374
During the lab, we will use GitHub Codespaces. These instructions are here just in case you can't use Codespaces or if you really, really, really want a local installation.
7475
:::
7576

76-
If you want to run the notebook locally, follow the steps below:
77+
To run the lab locally, follow the steps below:
7778

7879
* Clone the [GitHub repo](https://github.com/mongodb-developer/genai-devday-notebooks.git) for this lab by executing the following command from the terminal:
7980

8081
```
8182
git clone https://github.com/mongodb-developer/genai-devday-notebooks.git
8283
```
8384

84-
* `cd` into the cloned directory:
85+
* `cd` into the `notebooks` directory of the cloned repository:
8586

8687
```
87-
cd genai-devday-notebooks
88+
cd genai-devday-notebooks/notebooks
8889
```
8990

9091
* Create and activate a Python virtual environment:
9192

9293
```
93-
python -m venv mongodb-ai-agents-lab
94-
source mongodb-ai-agents-lab/bin/activate
94+
python -m venv ai-agents-lab
95+
source ai-agents-lab/bin/activate
9596
```
9697

9798
* Install the dependencies for this lab:
@@ -109,4 +110,4 @@ jupyter notebook
109110

110111
* In the browser tab that pops up, open the file named `ai-agents-lab.ipynb`.
111112

112-
<Screenshot url="localhost:8888/tree" src="img/screenshots/20-dev-env/1-dev-env-setup/11-jupyter-notebook.png" alt="Jupyter Notebook" />
113+
<Screenshot url="localhost:8888/tree" src="img/screenshots/20-dev-env/1-dev-env-setup/12-jupyter-notebook.png" alt="Jupyter Notebook" />
Loading
Loading

0 commit comments

Comments
 (0)