genai-toolbox/docs/en/getting-started/local_quickstart_js.md at b6835aedd33459efbd2fa77dcc01399cfa980caf

mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-02-04 20:25:05 -05:00

Files

Twisha Bansal 1e67810740 docs(toolbox-adk): Add quickstart for ADK JS SDK (#1862 )

## Description

## PR Checklist

> Thank you for opening a Pull Request! Before submitting your PR, there
are a
> few things you can do to make sure it goes smoothly:

- [x] Make sure you reviewed

[CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md)
- [ ] Make sure to open an issue as a

[bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose)
  before writing your code! That way we can discuss the change, evaluate
  designs, and agree on the general idea
- [x] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [x] Appropriate docs were updated (if necessary)
- [ ] Make sure to add `!` if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>

2025-12-04 12:17:05 +05:30

3.2 KiB

Raw Blame History

title, type, weight, description

title	type	weight	description
JS Quickstart (Local)	docs	3	How to get started running Toolbox locally with [JavaScript](https://github.com/googleapis/mcp-toolbox-sdk-js), PostgreSQL, and orchestration frameworks such as [LangChain](https://js.langchain.com/docs/introduction/), [GenkitJS](https://genkit.dev/docs/get-started/), [LlamaIndex](https://ts.llamaindex.ai/) and [GoogleGenAI](https://github.com/googleapis/js-genai).

Before you begin

This guide assumes you have already done the following:

Installed Node.js (v18 or higher).
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.

(Optional) Initialize a Node.js project:
```
npm init -y
```
In a new terminal, install the SDK package. {{< tabpane persist=header >}} {{< tab header="LangChain" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="GenkitJS" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="GoogleGenAI" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="ADK" lang="bash" >}} npm install @toolbox-sdk/adk {{< /tab >}} {{< /tabpane >}}
Install other required dependencies

{{< tabpane persist=header >}} {{< tab header="LangChain" lang="bash" >}} npm install langchain @langchain/google-genai {{< /tab >}} {{< tab header="GenkitJS" lang="bash" >}} npm install genkit @genkit-ai/googleai {{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}} npm install llamaindex @llamaindex/google @llamaindex/workflow {{< /tab >}} {{< tab header="GoogleGenAI" lang="bash" >}} npm install @google/genai {{< /tab >}} {{< tab header="ADK" lang="bash" >}} npm install @google/adk {{< /tab >}} {{< /tabpane >}}
Create a new file named hotelAgent.js and copy the following code to create an agent:

{{< tabpane persist=header >}} {{< tab header="LangChain" lang="js" >}}

Run your agent, and observe the results:
```
node hotelAgent.js
```

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

3.2 KiB Raw Blame History