add how to run in index

Author: geemi725

chapter_2/llms_for_biology.ipynb

@@ -13,7 +13,7 @@
         "\n",
         "As the volume of scientific literature continues to grow rapidly, manually extracting and organizing this information becomes increasingly difficult and time-consuming. Therefore, automating data extraction from the literature using AI can help researchers to rapidly identify relevant findings, convert unstructured text into structured datasets, and integrate knowledge across thousands of publications. \n",
         "\n",
-        "::{admonition} 🚀 Getting Started\n",
+        ":::{admonition} 🚀 Getting Started\n",
         ":class: tip\n",
         "\n",
         "This tutorial can be launched using the rocket button at the top of the page.\n",

chapter_3/agent_mcp_example.ipynb

@@ -8,7 +8,7 @@
     "\n",
     "In chapters 3.2 and 3.3 we learned how to write boilerplate code and implement agents. But the problem is, if you are not a python programmer you might find this to be tedious. This may not be the main problem you want to solve and might be interested in a simpler solution.\n",
     "\n",
-    "::{admonition} 🚀 Getting Started\n",
+    ":::{admonition} 🚀 Getting Started\n",
     ":class: tip\n",
     "\n",
     "This tutorial can be launched using the rocket button at the top of the page.\n",

chapter_3/aviary_agent_implementation.ipynb

@@ -20,7 +20,7 @@
         "Figure 3.2.1: An agent iteratively received observations from the environment, takes an action based on the observation until the task is completed.\n",
         "```\n",
         "\n",
-        "::{admonition} 🚀 Getting Started\n",
+        ":::{admonition} 🚀 Getting Started\n",
         ":class: tip\n",
         "\n",
         "This tutorial can be launched using the rocket button at the top of the page.\n",

index.md

@@ -23,6 +23,52 @@ By the end of this series, you should:
 
 - A curious mindset
 
-# Contact Us for Questions, Suggestions and Feedback
+# Using Tutorials
 
-Email us at: tutorials@futurehouse.org
+The tutorials can be launched using the rocket (🚀) button  at the top of the page.
+
+### Option 1 — Google Colab (**recommended**)
+Opens the notebook in Google Colab with the fastest and most reliable experience.
+
+Before running the tutorial, add your API keys using **either**:
+
+- a `.env` file, or
+- **Colab Secrets** (`🔑 Secrets` tab in the left sidebar)
+
+Example `.env`:
+```bash
+OPENAI_API_KEY=your_key_here
+ANTHROPIC_API_KEY=your_key_here
+```
+
+### Option 2 — MyBinder
+Launches a temporary cloud Jupyter environment directly in your browser.
+
+⚠️ Binder environments can take a few minutes to build and start.
+
+After the notebook loads, create a `.env` file in the notebook directory containing your API keys:
+
+```bash
+OPENAI_API_KEY=your_key_here
+ANTHROPIC_API_KEY=your_key_here
+```
+
+### Notes
+- You only need API keys for the providers used in a given notebook.
+- Never commit or publicly share your API keys.
+- If a cell fails due to missing credentials, verify that your keys were loaded correctly before rerunning the cell.
+
+
+# Contacting Us
+
+We’d love to hear from you! Whether you run into issues, have ideas for improving the tutorials, or want to suggest new topics, feel free to reach out. 
+
+Email us at: [tutorials@futurehouse.org](tutorials@futurehouse.org)
+
+When reporting an issue, it’s helpful to include:
+
+- The tutorial chapter number and/or title
+- Whether you used Google Colab or Binder
+- The full error message or screenshot (if available)
+
+We’re actively improving these tutorials and appreciate your feedback and contributions.