google-gemini · MarkDaoust · Feb 6, 2025 · Jan 24, 2025 · Jan 24, 2025 · Jan 27, 2025
diff --git a/.gitignore b/.gitignore
@@ -2,3 +2,4 @@
 **/.ipynb_checkpoints
 **/venv
 **/.python-version
+**/desktop.ini
diff --git a/Awesome_gemini.md b/Awesome_gemini.md
diff --git a/README.md b/README.md
@@ -19,8 +19,8 @@ Prefer the `google-genai` for any new code going forward.
 
 This cookbook is organized into two main categories:
 
-1.  **[Quick Starts](./quickstarts/):**  Step-by-step guides covering both introductory topics ("[Get Started](./quickstarts/Get_started.ipynb)") and specific API features.
-2.  **[Examples](./examples/):** Practical use cases demonstrating how to combine multiple features.
+1.  **[Quick Starts](https://github.com/google-gemini/cookbook/tree/main/quickstarts/):**  Step-by-step guides covering both introductory topics ("[Get Started](./quickstarts/Get_started.ipynb)") and specific API features.
+2.  **[Examples](https://github.com/google-gemini/cookbook/tree/main/examples/):** Practical use cases demonstrating how to combine multiple features.
 
 We also showcase **Demos** in separate repositories, illustrating end-to-end applications of the Gemini API.
 <br><br>
@@ -34,12 +34,13 @@ Here are the recent additions and updates to the Gemini API and the Cookbook:
 * **Recently Added Guides:**.
   * [Thinking model](./quickstarts/Get_started_thinking.ipynb): Discover the thinking model capabilities.
   * [Invoice and Form Data Extraction](./examples/Pdf_structured_outputs_on_invoices_and_forms.ipynb): Analyze PDFs with structured outputs.
-  * [Gradio and Live API](./examples/Code_.ipynb): Start working with Gradio to set-up your own live instance.
+  * [Code execution](./quickstarts/Code_Execution.ipynb): Generating and running Python code to solve complex tasks and even ouput graphs
+
 <br><br>
 
 ## 1. Quick Starts
 
-The [quickstarts section](./quickstarts/) contains step-by-step tutorials to get you started with Gemini and learn about its specific features.
+The [quickstarts section](https://github.com/google-gemini/cookbook/tree/main/quickstarts/) contains step-by-step tutorials to get you started with Gemini and learn about its specific features.
 
 **To begin, you'll need:**
 
@@ -53,20 +54,21 @@ We recommend starting with the following:
 *   [**Get started**](./quickstarts/Get_started.ipynb): Get started with Gemini models and the Gemini API, covering basic prompting and multimodal input.
 <br><br>
 
-Then, explore the other Quick Starts to learn about individual features:
+Then, explore the other quickstarts tutorials to learn about individual features:
+*  [Get started with Live API](./quickstarts/Get_started_LiveAPI.ipynb): Get started with the live API with this comprehensive overview of its capabilities
 *  [Grounding](./quickstarts/Search_Grounding.ipynb): use Google Search for grounded responses
-*  [Code execution](./quickstarts/Code_Execution.ipynb): SGenerating and running Python code to solve complex tasks
-*  And [many more](./quickstarts/)
+*  [Code execution](./quickstarts/Code_Execution.ipynb): Generating and running Python code to solve complex tasks and even ouput graphs
+*  And [many more](https://github.com/google-gemini/cookbook/tree/main/quickstarts/)
 <br><br>
 
 ## 2. Examples (Practical Use Cases)
 
 These examples demonstrate how to combine multiple Gemini API features or 3rd-party tools to build more complex applications.
-*  [Plotting and mapping Live](./LiveAPI_plotting_and_mapping.ipynb): Mix *Live API* and *Code execution* to solve complex tasks live.
-*  [Search grounding for research report](./Search_grounding_for_research_report.ipynb): Use *Grounding* to improve the quality of your research report
-*  [3D Spatial understanding](./Spatial_understanding_3d.ipynb): Use Gemini *3D spatial* abilities to understand 3D scenes
-*  [Gradio and live API](./gradio_audio.py): Use gradio to deploy your own instance of the *Live API*
-*  And [many many more](./examples/)
+*  [Plotting and mapping Live](./examples/LiveAPI_plotting_and_mapping.ipynb): Mix *Live API* and *Code execution* to solve complex tasks live.
+*  [Search grounding for research report](./examples/Search_grounding_for_research_report.ipynb): Use *Grounding* to improve the quality of your research report
+*  [3D Spatial understanding](./examples/Spatial_understanding_3d.ipynb): Use Gemini *3D spatial* abilities to understand 3D scenes
+*  [Gradio and live API](./examples/gradio_audio.py): Use gradio to deploy your own instance of the *Live API*
+*  And [many many more](https://github.com/google-gemini/cookbook/tree/main/examples/)
 <br><br>
 
 ## 3. Demos (End-to-End Applications)
@@ -81,7 +83,7 @@ These fully functional, end-to-end applications showcase the power of Gemini in
 
 ## Official SDKs
 
-The Gemini API is a REST API. You can call it directly using tools like `curl` (see [REST examples](./quickstarts/rest/)), or use one of our official SDKs:
+The Gemini API is a REST API. You can call it directly using tools like `curl` (see [REST examples](https://github.com/google-gemini/cookbook/tree/main/quickstarts/rest/)), or use one of our official SDKs:
 * [Python](https://github.com/googleapis/python-genai)
 * [Go](https://github.com/google/generative-ai-go)
 * [Node.js](https://github.com/google/generative-ai-js)

diff --git a/examples/Analyze_a_Video_Classification.ipynb b/examples/Analyze_a_Video_Classification.ipynb
@@ -124,7 +124,7 @@
       "source": [
         "## Example\n",
         "\n",
-        "This example uses a [video](https://commons.wikimedia.org/wiki/File:American_black_bears_(Ursus_americanus).webm) published by Bryon Evans containing an American black bear.\n",
+        "This example uses a [video](https://commons.wikimedia.org/wiki/File:American_black_bears_%28Ursus_americanus%29.webm) published by Bryon Evans containing an American black bear.\n",
         "\n",
         "The video falls under the [Creative Commons Attribution 3.0 Unported license](https://creativecommons.org/licenses/by/3.0/deed.en)."
       ]

diff --git a/examples/LiveAPI_plotting_and_mapping.ipynb b/examples/LiveAPI_plotting_and_mapping.ipynb
@@ -1100,11 +1100,11 @@
         "This guide shows more intermedite use of the Multimodal Live API over Websockets.\n",
         "\n",
         "- To try multimodal streaming, use [Live API in Google AI Studio](https://aistudio.google.com/app/live) - no code required.\n",
-        "- Check out the [Live API starter using the Python SDK](../gemini-2/live_api_starter.ipynb) or using [websockets](../gemini-2/websockets/live_api_starter.ipynb).\n",
-        "- Try some other [search](../gemini-2/search_tool.ipynb) examples.\n",
-        "- Try the [Tool use in the live API tutorial](../gemini-2/live_api_tool_use.ipynb) for a walkthrough of Gemini 2.0's new tool use capabilities.\n",
+        "- Check out the [Live API starter using the Python SDK](../quickstarts/Get_started_LiveAPI.ipynb) or using [websockets](../gemini-2/websockets/live_api_starter.ipynb).\n",
+        "- Try some other [grounding](../examples/Search_grounding_for_research_report.ipynb) examples.\n",
+        "- Try the [Tool use in the live API tutorial](../quickstarts/Get_started_LiveAPI_tools.ipynb) for a walkthrough of Gemini 2.0's new tool use capabilities.\n",
         "\n",
-        "Or just check the other Gemini 2.0 capabilities illustrated in the [Cookbook](https://github.com/google-gemini/cookbook/blob/main/gemini-2/) examples."
+        "Or just check the other Gemini 2.0 capabilities illustrated in the [Cookbook](https://github.com/google-gemini/cookbook/tree/main/gemini-2/) examples."
       ]
     }
   ],

diff --git a/examples/README.md b/examples/README.md
@@ -9,14 +9,17 @@ For introductions to those features it is recommended to start with the [Quickst
 
 This is a collection of fun and helpful examples for the Gemini API. 
 
-* [Plotting and mapping Live](./LiveAPI_plotting_and_mapping.ipynb): Ask Gemini for complex graphs live (Uses **Live API** and **Code execution**)
-* [Search grounding for research report](./Search_grounding_for_research_report.ipynb): Use grounding to improve the quality of your research report (Uses **Grounding**)
-* [3D Spatial understanding](./Spatial_understanding_3d.ipynb): Use Gemini 3D spatial abilities to understand 3D scenes and answer questions about them (Uses **Multimodal** and **Spatial understanding**)
-* [Gradio and live API](./gradio_audio.py): Use gradio to deploy your own instance of the Live API (Uses **Live API**)
-* [Automated Invoice and Form Data Extraction with Gemini API & Pydantic](./Pdf_structured_outputs_on_invoices_and_forms.ipynb): Use the Gemini API to extract information from PDFs (Uses **File API** and **Structured Outputs**)
-<br><br>
+| Cookbook | Description | Features | Open |
+| -------- | ----------- | -------- | ---- |
+| [Plotting and mapping Live](./LiveAPI_plotting_and_mapping.ipynb) | Ask Gemini for complex graphs live | Live API, Code execution | [![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/examples/LiveAPI_plotting_and_mapping.ipynb) |
+| [Search grounding for research report](./Search_grounding_for_research_report.ipynb) | Use grounding to improve the quality of your research report | Grounding | [![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/examples/Search_grounding_for_research_report.ipynb) |
+| [3D Spatial understanding](./Spatial_understanding_3d.ipynb) | Use Gemini 3D spatial abilities to understand 3D scenes and answer questions about them | Multimodal, Spatial understanding | [![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/examples/Spatial_understanding_3d.ipynb) |
+| [Gradio and live API](./gradio_audio.py) | Use gradio to deploy your own instance of the Live API | Live API | [Python Code](./gradio_audio.py) |
+| [Invoice and Form Data Extraction](./Pdf_structured_outputs_on_invoices_and_forms.ipynb) | Use the Gemini API to extract information from PDFs | File API, Structured Outputs | [![Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/google-gemini/cookbook/blob/main/examples/Pdf_structured_outputs_on_invoices_and_forms.ipynb) |
+
 
 ---
+<br>
 Some old examples are still using the legacy SDK, they should still work and are still worth checking to get ideas:
 
 * [Agents and Automatic Function Calling](./Agents_Function_Calling_Barista_Bot.ipynb): Create an agent (Barrista-bot) to take your coffee order. 
@@ -48,7 +51,7 @@ Some old examples are still using the legacy SDK, they should still work and are
 
 ### Folders
 
-* [Prompting examples](./prompting): A directory with examples of various prompting techniques. 
-* [JSON Capabilities](./json-capabilities): A directory with guides containing different types of tasks you can do with JSON schemas.
-* [Automate Google Workspace tasks with the Gemini API](./Apps_script_and_Workspace_codelab): This codelabs shows you how to connect to the Gemini API using Apps Script, and uses the function calling, vision and text capabilities to automate Google Workspace tasks - summarizing a document, analyzing a chart, sending an email and generating some slides directly. All of this is done from a free text input.
-* [Langchain examples](./langchain): A directory with multiple examples using Gemini with Langchain.
+* [Prompting examples](./prompting/): A directory with examples of various prompting techniques. 
+* [JSON Capabilities](./json_capabilities/): A directory with guides containing different types of tasks you can do with JSON schemas.
+* [Automate Google Workspace tasks with the Gemini API](./Apps_script_and_Workspace_codelab/): This codelabs shows you how to connect to the Gemini API using Apps Script, and uses the function calling, vision and text capabilities to automate Google Workspace tasks - summarizing a document, analyzing a chart, sending an email and generating some slides directly. All of this is done from a free text input.
+* [Langchain examples](./langchain/): A directory with multiple examples using Gemini with Langchain.
diff --git a/examples/Search_grounding_for_research_report.ipynb b/examples/Search_grounding_for_research_report.ipynb
@@ -1149,9 +1149,9 @@
         "\n",
         "* To learn more about the search tool, check out the [Search tool documentation](https://ai.google.dev/gemini-api/docs/models/gemini-v2#search-tool).\n",
         "* To get started with streaming, check out the [Streaming Quickstart](../quickstarts/Streaming.ipynb).\n",
-        "* To get started with the search tool, check out the [Search tool quick start](https://github.com/google-gemini/cookbook/blob/main/gemini-2/search_tool.ipynb).\n",
+        "* To get started with the search tool, check out the [Search tool quick start](../quickstarts/Search_Grounding.ipynb).\n",
         "* To see how much easier and more powerful the search tool in Gemini 2.0 is than the previous search grounding feature, compare this tutorial with the [previous example](../examples/Search_grounding_for_research_report.ipynb).\n",
-        "* To learn more about all the new Gemini 2.0 features, check out the [Gemini 2.0 quickstart notebooks](../gemini-2/)."
+        "* To learn more about all the new Gemini 2.0 features, check out the [Gemini 2.0 quickstart notebooks](https://github.com/google-gemini/cookbook/tree/main/gemini-2/)."
       ]
     }
   ],