colab links in the README.

* colab links in the README.

* Fix colab links and put in updates to Notebooks

---------

Co-authored-by: Kenneth Ocheltree <[email protected]>

Author: 2 people

README.md

@@ -39,12 +39,17 @@ with structured, maintainable, robust, and efficient AI workflows.
 
 
 ## Getting Started
+
+You can get started with a local install, or by using Colab notebooks.
+
+### Getting Started with Local Infernece
+
 <img src="docs/GetStarted_py.png" style="max-width:800px">
 
 Install with pip:
 
 ```bash
-uv pip install .
+uv pip install mellea
 ```
 
 > [!NOTE]
@@ -69,6 +74,23 @@ Then run it:
 uv run --with mellea docs/examples/tutorial/example.py
 ```
 
+### Get Started with Colab
+
+| Notebook | Try in Colab | Goal |
+|----------|--------------|------|
+| Hello, World | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/example.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Quick‑start demo |
+| Simple Email | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/simple_email.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Using the `m.instruct` primitive |
+| Instruct-Validate-Repair | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/instruct_validate_repair.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Introduces our first generative programming design pattern |
+| Model Options | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notsbooks/model_options_example.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Demonstrates how to pass model options through to backends |
+| Sentiment Classifier | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/sentiment_classifier.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Introduces the `@generative` decorator |
+| Managing Context | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main//docs/examples/notebooks/context_example.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Shows how to construct and manage context in a `MelleaSession` |
+| Generative OOP | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/table_mobject.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Demonstrates object-oriented generative programming in Mellea |
+| Rich Documents | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/document_mobject.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | A generative program that uses Docling to work with rich-text documents |
+| Composing Generative Functions | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/compositionality_with_generative_slots.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Demonstrates contract-oriented programming in Mellea |
+| `m serve` | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/m_serve_example.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Serve a generative program as an openai-compatible model endpoint |
+| MCP | <a href="https://colab.research.google.com/github/generative-computing/mellea/blob/main/docs/examples/notebooks/mcp_example.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> | Mellea + MCP |
+
+
 ### Installing from source
 
 Fork and clone the repositoy:

docs/examples/notebooks/context_example.ipynb

@@ -10,19 +10,6 @@
     "This Jupyter notebook runs on Colab and demonstrates context management."
    ]
   },
-  {
-   "cell_type": "markdown",
-   "metadata": {
-    "id": "IByYhgKy9WCo",
-    "jupyter": {
-     "source_hidden": true
-    }
-   },
-   "source": [
-    "# Getting Started with Mellea\n",
-    "This Jupyter notebook runs on Colab and runs the first piece of generative code."
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {

docs/examples/notebooks/instruct_validate_repair.ipynb

@@ -52,7 +52,7 @@
    "outputs": [],
    "source": [
     "import os\n",
-    "!git clone https://github.com/generative-computing/mellea.git --quiet --recurse-submodules\n",
+    "!git clone https://github.com/generative-computing/mellea.git --quiet\n",
     "os.chdir(\"mellea\")\n",
     "!uv pip install . -qq"
    ]

docs/examples/notebooks/m_serve_example.ipynb

@@ -62,7 +62,7 @@
    "outputs": [],
    "source": [
     "import os\n",
-    "!git clone https://github.com/generative-computing/mellea.git --quiet --recurse-submodules\n",
+    "!git clone https://github.com/generative-computing/mellea.git --quiet\n",
     "os.chdir(\"mellea\")\n",
     "!uv pip install . -qq"
    ]

docs/examples/notebooks/mcp_example.ipynb

@@ -8,7 +8,7 @@
    },
    "source": [
     "# Model Context Protocol (MCP) Server Example \n",
-    "This Jupyter notebook runs on COlab and demonstrates a MCP server running Mellea. "
+    "This Jupyter notebook runs on Colab and demonstrates a MCP server running Mellea. "
    ]
   },
   {

docs/examples/notebooks/model_options_example.ipynb

@@ -52,7 +52,7 @@
    "outputs": [],
    "source": [
     "import os\n",
-    "!git clone https://github.com/generative-computing/mellea.git --quiet --recurse-submodules\n",
+    "!git clone https://github.com/generative-computing/mellea.git --quiet\n",
     "os.chdir(\"mellea\")\n",
     "!uv pip install . -qq"
    ]

docs/examples/notebooks/simple_email.ipynb

@@ -52,7 +52,7 @@
    "outputs": [],
    "source": [
     "import os\n",
-    "!git clone https://github.com/generative-computing/mellea.git --quiet --recurse-submodules\n",
+    "!git clone https://github.com/generative-computing/mellea.git --quiet\n",
     "os.chdir(\"mellea\")\n",
     "!uv pip install . -qq"
    ]