genai-toolbox/docs/en/getting-started/local_quickstart_go.md at d8559ed52dc8895eed56a2b88e1ea201cc96eb8e

mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-02-18 11:02:26 -05:00

Files

dishaprakash d4ff6bebe9 docs(Go SDK): Update documentation for the refactored Go SDK (#2479 )

## Description

This PR updates the documentation after the refactor of the Go SDK into
a multi-module structure

## 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
- [x] 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>

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

2026-02-17 00:39:11 +05:30

3.5 KiB

Raw Blame History

title, type, weight, description

title	type	weight	description
Go Quickstart (Local)	docs	4	How to get started running Toolbox locally with [Go](https://github.com/googleapis/mcp-toolbox-sdk-go), PostgreSQL, and orchestration frameworks such as [LangChain Go](https://tmc.github.io/langchaingo/docs/), [GenkitGo](https://genkit.dev/go/docs/get-started-go/), [Go GenAI](https://github.com/googleapis/go-genai) and [OpenAI Go](https://github.com/openai/openai-go).

Before you begin

This guide assumes you have already done the following:

Installed Go (v1.24.2 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.

Initialize a go module:
```
go mod init main
```
In a new terminal, install the Go SDK Module: {{< notice warning >}} Breaking Change Notice: As of version 0.6.0, this SDK has transitioned to a multi-module structure.
- For new versions (v0.6.0+): You must import specific modules (e.g., go get github.com/googleapis/mcp-toolbox-sdk-go/core).
- For older versions (v0.5.1 and below): The SDK remains a single-module library (go get github.com/googleapis/mcp-toolbox-sdk-go).
- Please update your imports and go.mod accordingly when upgrading. {{< /notice >}}
{{< tabpane persist=header >}} {{< tab header="LangChain Go" lang="bash" >}} go get github.com/googleapis/mcp-toolbox-sdk-go/core {{< /tab >}}

{{< tab header="Genkit Go" lang="bash" >}} go get github.com/googleapis/mcp-toolbox-sdk-go/core go get github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit {{< /tab >}}

{{< tab header="Go GenAI" lang="bash" >}} go get github.com/googleapis/mcp-toolbox-sdk-go/core {{< /tab >}}

{{< tab header="OpenAI Go" lang="bash" >}} go get github.com/googleapis/mcp-toolbox-sdk-go/core {{< /tab >}}

{{< tab header="ADK Go" lang="bash" >}} go get github.com/googleapis/mcp-toolbox-sdk-go/core go get github.com/googleapis/mcp-toolbox-sdk-go/tbadk {{< /tab >}} {{< /tabpane >}}
Create a new file named hotelagent.go and copy the following code to create an agent:

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

Ensure all dependencies are installed:
```
go mod tidy
```
Run your agent, and observe the results:
```
go run hotelagent.go
```

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

3.5 KiB Raw Blame History