genai-toolbox/docs/en/getting-started/quickstart/shared/configure_toolbox.md

In this section, we will download Toolbox, configure our tools in a tools.yaml, and then run the Toolbox server.

1. Download the latest version of Toolbox as a binary:

   {{< notice tip >}} Select the correct binary corresponding to your OS and CPU architecture. {{< /notice >}}

   export OS="linux/amd64" # one of linux/amd64, darwin/arm64, darwin/amd64, or windows/amd64
   curl -O https://storage.googleapis.com/genai-toolbox/v0.27.0/$OS/toolbox
   

2. Make the binary executable:

   chmod +x toolbox
   

3. Write the following into a tools.yaml file. Be sure to update any fields such as user, password, or database that you may have customized in the previous step.

   {{< notice tip >}} In practice, use environment variable replacement with the format ${ENV_NAME} instead of hardcoding your secrets into the configuration file. {{< /notice >}}

   kind: sources
   name: my-pg-source
   type: postgres
   host: 127.0.0.1
   port: 5432
   database: toolbox_db
   user: toolbox_user
   password: my-password
   ---
   kind: tools
   name: search-hotels-by-name
   type: postgres-sql
   source: my-pg-source
   description: Search for hotels based on name.
   parameters:
     - name: name
       type: string
       description: The name of the hotel.
   statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';
   ---
   kind: tools
   name: search-hotels-by-location
   type: postgres-sql
   source: my-pg-source
   description: Search for hotels based on location.
   parameters:
     - name: location
       type: string
       description: The location of the hotel.
   statement: SELECT * FROM hotels WHERE location ILIKE '%' || $1 || '%';
   ---
   kind: tools
   name: book-hotel
   type: postgres-sql
   source: my-pg-source
   description: >-
      Book a hotel by its ID. If the hotel is successfully booked, returns a NULL, raises an error if not.
   parameters:
     - name: hotel_id
       type: string
       description: The ID of the hotel to book.
   statement: UPDATE hotels SET booked = B'1' WHERE id = $1;
   ---
   kind: tools
   name: update-hotel
   type: postgres-sql
   source: my-pg-source
   description: >-
     Update a hotel's check-in and check-out dates by its ID. Returns a message
     indicating  whether the hotel was successfully updated or not.
   parameters:
     - name: hotel_id
       type: string
       description: The ID of the hotel to update.
     - name: checkin_date
       type: string
       description: The new check-in date of the hotel.
     - name: checkout_date
       type: string
       description: The new check-out date of the hotel.
   statement: >-
     UPDATE hotels SET checkin_date = CAST($2 as date), checkout_date = CAST($3
     as date) WHERE id = $1;
   ---
   kind: tools
   name: cancel-hotel
   type: postgres-sql
   source: my-pg-source
   description: Cancel a hotel by its ID.
   parameters:
     - name: hotel_id
       type: string
       description: The ID of the hotel to cancel.
   statement: UPDATE hotels SET booked = B'0' WHERE id = $1;
   ---
   kind: toolsets
   name: my-toolset
   tools:
     - search-hotels-by-name
     - search-hotels-by-location
     - book-hotel
     - update-hotel
     - cancel-hotel
   

   For more info on tools, check out the Resources section of the docs.

4. Run the Toolbox server, pointing to the tools.yaml file created earlier:

   ./toolbox --tools-file "tools.yaml"
   

   {{< notice note >}} Toolbox enables dynamic reloading by default. To disable, use the --disable-reload flag. {{< /notice >}}