Skip to content

docs: migration of Python Sdk docs#2164

Merged
rapid-killer-9 merged 11 commits intosdk-docs-migratefrom
py-sdk-docs
Feb 23, 2026
Merged

docs: migration of Python Sdk docs#2164
rapid-killer-9 merged 11 commits intosdk-docs-migratefrom
py-sdk-docs

Conversation

@rapid-killer-9
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 commented Dec 12, 2025

Docs Migration from python SDK repo to genai-toolbox repo.

This branch is used as parent branch for python Sdk docs migration

child branch:

  1. docs: python toolbox-core sdk doc migration  #2166
  2. docs: python toolbox-langchain sdk doc migration  #2190
  3. docs: python toolbox-llamaindex sdk doc migration #2291
  4. docs: python toolbox-adk sdk doc migration #2409

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @rapid-killer-9, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the Python SDK documentation by integrating new sections that clarify package selection and provide a comprehensive overview of the available SDKs. The changes aim to improve user experience by offering explicit guidance on choosing the correct SDK for various application frameworks and presenting a structured summary of each package's purpose and details.

Highlights

  • Package Selection Guidance: Added a new section titled "Which Package Should I Use?" to the Python SDK documentation. This section provides clear guidance to users on selecting the appropriate SDK package (toolbox-langchain, toolbox-llamaindex, or toolbox-core) based on their application's specific AI orchestration framework or custom needs.
  • Available Packages Overview: Introduced a new section "Available Packages" which includes a detailed table. This table summarizes the toolbox-core, toolbox-langchain, and toolbox-llamaindex packages, outlining their target use cases, integration details, file paths, links to their respective READMEs, and current PyPI status.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Python SDK documentation to include guidance on which package to use and a summary table of available packages. The changes are clear and helpful. I've added a few comments to fix a broken link, improve formatting, and adhere to common file conventions.

Comment thread docs/en/sdks/python-sdk/_index.md
Comment thread docs/en/sdks/python-sdk/_index.md Outdated
Comment thread docs/en/sdks/python-sdk/_index.md Outdated
Comment thread docs/en/sdks/python-sdk/_index.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 added the type: docs Improvement to the documentation for an API. label Dec 12, 2025
@github-actions
Copy link
Copy Markdown
Contributor

@Yuan325 Yuan325 changed the title Migration of Python Sdk docs docs: migration of Python Sdk docs Dec 27, 2025
@Yuan325 Yuan325 added the priority: p3 Desirable enhancement or fix. May not be included in next release. label Dec 27, 2025
@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

Copy link
Copy Markdown
Contributor

@anubhav756 anubhav756 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please make sure to:

  • Also update the respective SDK repos READMEs to have minimal instructions and deep-link to the guides on this docsite.
  • Ensure we have the latest changes from all the SDK repos' READMEs right before we remove the existing content from them (as they are migrated here now) and replace them with appropriate minimal instructions.

rapid-killer-9 and others added 3 commits February 23, 2026 14:01
This PR migrates the toolbox-adk Python SDK documentation to the main
documentation site. It ensures all technical guides and references are
centralized and up-to-date with the latest project standards.  

**Key Changes**

- Documentation Migration: Ported comprehensive content from the Python
SDK repository to the main docsite, covering installation, basic usage,
and advanced configurations.  

- Compatibility Updates: Updated the documentation to support the
current Hugo version used by the site.  
 
- Model Update: Updated all Gemini model references to Gemini 3 Preview
to align with the latest SDK capabilities.  
 
- Content Enhancement: Added detailed guides for:
 
- Transport Protocols: Documentation on supported transport protocols,
including Model Context Protocol (MCP) and native Toolbox HTTP.
 
- Authentication Strategies: Extensive coverage of various
authentication methods using CredentialStrategy, such as Workload
Identity, OAuth2, API keys, and manual credentials.
 
- Advanced Configuration: Outlined options for adding custom headers,
global parameter binding, and implementing pre_hook and post_hook
functions for tool invocation.

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
## Description

Migrating docs from python Sdk to the main docsite for
`toolbox-llamaindex`

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
This PR migrates the toolbox-langchain Python SDK documentation to the
main documentation site. It ensures all technical guides and references
are centralized and up-to-date with the latest project standards.

**Key Changes**

- Documentation Migration: Ported comprehensive content from the Python
SDK repository to the main docsite, covering installation, quickstart
examples, and detailed usage instructions for integrating with popular
AI frameworks like LangChain and LangGraph.

- Compatibility Updates: Updated the documentation to support the
current Hugo version used by the site.
 
- Model Update: Updated all Gemini model references to Gemini 3 Preview
to align with the latest SDK capabilities.
 
- Content Enhancement: Added detailed guides for:
 
- Framework Integration: Detailed examples and guidance on integrating
the SDK with both LangChain and LangGraph, including graph
configurations.
 
- Authentication Mechanisms: Coverage of client-to-server authentication
(specifically for Google Cloud environments like Cloud Run) and
tool-specific authentication using OIDC/Google OAuth 2.0 ID tokens.
 
- Advanced Usage: Guidance on binding parameter values to tools for
security and consistency, alongside instructions for utilizing
asynchronous interfaces to improve performance.

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

This PR migrates the toolbox-core Python SDK documentation to the main
documentation site. It ensures all technical guides and references are
centralized and up-to-date with the latest project standards.  

**Key Changes**

- Documentation Migration: Ported comprehensive content from the Python
SDK repository to the main docsite, covering installation, setup, and
core features.  

- Compatibility Updates: Updated the documentation to support the
current Hugo version used by the site.  
 
- Model Update: Updated all Gemini model references to Gemini 3 Preview
to align with the latest SDK capabilities.  
 
- Content Enhancement: Added detailed guides for:
 
- SDK Usage and Quickstart: Clear instructions for installation and
minimal examples for both asynchronous and synchronous operations.  
 
- Authentication Mechanisms: Guidance for client-to-server
authentication (e.g., Cloud Run) and per-tool authentication using ID
token retriever functions.  
 
- Advanced Features: Detailed explanations on binding parameter values
to tools, either statically or dynamically.  
 
- Framework Integration: Practical integration examples with frameworks
such as LangGraph.

---------

Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

@rapid-killer-9 rapid-killer-9 merged commit aa37700 into sdk-docs-migrate Feb 23, 2026
15 checks passed
@rapid-killer-9 rapid-killer-9 deleted the py-sdk-docs branch February 23, 2026 08:47
@github-actions
Copy link
Copy Markdown
Contributor

🧨 Preview deployments removed.

rapid-killer-9 added a commit that referenced this pull request Feb 23, 2026
Docs Migration across Sdk  repo (py, js & go) to genai-toolbox repo

This is a parent branch for all the sdks 
py - #2164
js - #2329
go - #2292



This pr will also solve
[Issue](#1182)

---------

Co-authored-by: Anmol Shukla <shuklaanmol@google.com>
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
github-actions bot pushed a commit that referenced this pull request Feb 23, 2026
Docs Migration across Sdk  repo (py, js & go) to genai-toolbox repo

This is a parent branch for all the sdks
py - #2164
js - #2329
go - #2292

This pr will also solve
[Issue](#1182)

---------

Co-authored-by: Anmol Shukla <shuklaanmol@google.com>
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> 87f2eaf
github-actions bot pushed a commit to Jaleel-zhu/genai-toolbox that referenced this pull request Feb 23, 2026
)

Docs Migration across Sdk  repo (py, js & go) to genai-toolbox repo

This is a parent branch for all the sdks
py - googleapis#2164
js - googleapis#2329
go - googleapis#2292

This pr will also solve
[Issue](googleapis#1182)

---------

Co-authored-by: Anmol Shukla <shuklaanmol@google.com>
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> 87f2eaf
github-actions bot pushed a commit to renovate-bot/googleapis-_-genai-toolbox that referenced this pull request Feb 23, 2026
)

Docs Migration across Sdk  repo (py, js & go) to genai-toolbox repo

This is a parent branch for all the sdks
py - googleapis#2164
js - googleapis#2329
go - googleapis#2292

This pr will also solve
[Issue](googleapis#1182)

---------

Co-authored-by: Anmol Shukla <shuklaanmol@google.com>
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> 87f2eaf
NightStack15 added a commit to NightStack15/googleapis-_-genai-toolbox that referenced this pull request Mar 20, 2026
Docs Migration across Sdk  repo (py, js & go) to genai-toolbox repo

This is a parent branch for all the sdks 
py - googleapis/mcp-toolbox#2164
js - googleapis/mcp-toolbox#2329
go - googleapis/mcp-toolbox#2292



This pr will also solve
[Issue](googleapis/mcp-toolbox#1182)

---------

Co-authored-by: Anmol Shukla <shuklaanmol@google.com>
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: p3 Desirable enhancement or fix. May not be included in next release. type: docs Improvement to the documentation for an API.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants