genai-toolbox/docs/en/getting-started/local_quickstart.md

title, type, weight, description

title	type	weight	description
Python Quickstart (Local)	docs	2	How to get started running Toolbox locally with [Python](https://github.com/googleapis/mcp-toolbox-sdk-python), PostgreSQL, and [Agent Development Kit](https://google.github.io/adk-docs/), [LangGraph](https://www.langchain.com/langgraph), [LlamaIndex](https://www.llamaindex.ai/) or [GoogleGenAI](https://pypi.org/project/google-genai/).

Before you begin

This guide assumes you have already done the following:

1. Installed Python 3.9+ (including pip and your preferred virtual environment tool for managing dependencies e.g. venv).
2. Installed PostgreSQL 16+ and the psql client.

Cloud Setup (Optional)

{{< regionInclude "quickstart/shared/cloud_setup.md" "cloud_setup" >}}

Step 1: Set up your database

{{< regionInclude "quickstart/shared/database_setup.md" "database_setup" >}}

Step 2: Install and configure Toolbox

{{< regionInclude "quickstart/shared/configure_toolbox.md" "configure_toolbox" >}}

Step 3: Connect your agent to Toolbox

In this section, we will write and run an agent that will load the Tools from Toolbox.

{{< notice tip>}} If you prefer to experiment within a Google Colab environment, you can connect to a local runtime. {{< /notice >}}

1. In a new terminal, install the SDK package.

   {{< tabpane persist=header >}} {{< tab header="ADK" lang="bash" >}}

pip install toolbox-core {{< /tab >}} {{< tab header="Langchain" lang="bash" >}}

pip install toolbox-langchain {{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}}

pip install toolbox-llamaindex {{< /tab >}} {{< tab header="Core" lang="bash" >}}

pip install toolbox-core {{< /tab >}} {{< /tabpane >}}

1. Install other required dependencies:

   {{< tabpane persist=header >}} {{< tab header="ADK" lang="bash" >}}

pip install google-adk {{< /tab >}} {{< tab header="Langchain" lang="bash" >}}

TODO(developer): replace with correct package if needed

pip install langgraph langchain-google-vertexai

pip install langchain-google-genai

pip install langchain-anthropic

{{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}}

TODO(developer): replace with correct package if needed

pip install llama-index-llms-google-genai

pip install llama-index-llms-anthropic

{{< /tab >}} {{< tab header="Core" lang="bash" >}}

pip install google-genai {{< /tab >}} {{< /tabpane >}}

1. Create a new file named hotel_agent.py and copy the following code to create an agent: {{< tabpane persist=header >}} {{< tab header="ADK" lang="python" >}}

{{< include "quickstart/python/adk/quickstart.py" >}}

{{< /tab >}} {{< tab header="LangChain" lang="python" >}}

{{< include "quickstart/python/langchain/quickstart.py" >}}

{{< /tab >}} {{< tab header="LlamaIndex" lang="python" >}}

{{< include "quickstart/python/llamaindex/quickstart.py" >}}

{{< /tab >}} {{< tab header="Core" lang="python" >}}

{{< include "quickstart/python/core/quickstart.py" >}}

{{< /tab >}} {{< /tabpane >}}

{{< tabpane text=true persist=header >}}

{{% tab header="ADK" lang="en" %}} To learn more about Agent Development Kit, check out the ADK documentation. {{% /tab %}} {{% tab header="Langchain" lang="en" %}} To learn more about Agents in LangChain, check out the LangGraph Agent documentation. {{% /tab %}} {{% tab header="LlamaIndex" lang="en" %}} To learn more about Agents in LlamaIndex, check out the LlamaIndex AgentWorkflow documentation. {{% /tab %}} {{% tab header="Core" lang="en" %}} To learn more about tool calling with Google GenAI, check out the Google GenAI Documentation. {{% /tab %}} {{< /tabpane >}}

1. Run your agent, and observe the results:

   python hotel_agent.py
   

{{< notice info >}} For more information, visit the Python SDK repo. {{</ notice >}}