> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Voker with Gemini

## Installation

<Tabs>
  <Tab title="Python">
    Make sure the Gemini SDK is installed:

    <CodeGroup>
      ```bash pip theme={null}
      pip install google-genai
      ```

      ```bash uv theme={null}
      uv add google-genai
      ```

      ```bash poetry theme={null}
      poetry add google-genai
      ```
    </CodeGroup>

    Make sure the Voker Python SDK is [installed](/sdks/python#installation).
  </Tab>

  <Tab title="TypeScript">
    Make sure the Gemini SDK is installed:

    <CodeGroup>
      ```bash npm theme={null}
      npm install @google/genai
      ```

      ```bash pnpm theme={null}
      pnpm add @google/genai
      ```

      ```bash bun theme={null}
      bun add @google/genai
      ```

      ```bash yarn theme={null}
      yarn add @google/genai
      ```
    </CodeGroup>

    Make sure the Voker Typescript SDK is [installed](/sdks/typescript#installation).
  </Tab>
</Tabs>

<Note>the SDK does not currently support Audio, Video or Image modalities.</Note>

## Usage

<Tabs>
  <Tab title="Python">
    ### Generate Content

    ```py theme={null}
    from google.genai import Client  # [!code --]
    from voker.ai.provider_gemini import Client  # [!code ++]

    client = Client()

    client.models.generate_content(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gemini-2.5-flash",
        contents="Write a poem about spring.",
    )
    ```

    ### Async Generate Content

    ```py theme={null}
    from google.genai import Client  # [!code --]
    from voker.ai.provider_gemini import Client  # [!code ++]

    client = Client()

    await client.aio.models.generate_content(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gemini-2.5-flash",
        contents="Write a poem about spring.",
    )
    ```

    ### Interactions

    ```py theme={null}
    from google.genai import Client  # [!code --]
    from voker.ai.provider_gemini import Client  # [!code ++]

    client = Client()

    client.interactions.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gemini-2.5-flash",
        input="Tell me a short joke about programming.",
    )
    ```

    ### Async Interactions

    ```py theme={null}
    from google.genai import Client  # [!code --]
    from voker.ai.provider_gemini import Client  # [!code ++]

    client = Client()

    client.aio.interactions.create(
        voker_agent="customer-support-agent",  # required  [!code ++]
        voker_session="user-session-1",  # required  [!code ++]
        model="gemini-2.5-flash",
        input="Tell me a short joke about programming.",
    )
    ```
  </Tab>

  <Tab title="TypeScript">
    ### Generate Content

    ```ts theme={null}
    import { GoogleGenAI } from '@google/genai'; // [!code --]
    import { GoogleGenAI } from '@voker/voker/ai/provider-gemini'; // [!code ++]

    const ai = new GoogleGenAI({ apiKey: 'gemini-api-key' });

    await ai.models.generateContent({
        vokerAgent: 'customer-support-agent', // required // [!code ++]
        vokerSession: 'user-session-1', // required // [!code ++]
        model: 'gemini-2.5-flash',
        contents: 'Hello, world!',
    });
    ```

    ### Interactions

    ```ts theme={null}
    import { GoogleGenAI } from '@google/genai'; // [!code --]
    import { GoogleGenAI } from '@voker/voker/ai/provider-gemini'; // [!code ++]

    const ai = new GoogleGenAI({ apiKey: 'gemini-api-key' });

    await ai.interactions.create({
        vokerAgent: 'customer-support-agent', // required // [!code ++]
        vokerSession: 'user-session-1', // required // [!code ++]
        model: 'gemini-2.5-flash',
        input: 'Hello, world!',
    });
    ```
  </Tab>
</Tabs>

## Next steps

* [Python SDK reference](/sdks/python) - environment setup, API key configuration, and full method reference.
* [TypeScript SDK reference](/sdks/typescript) - installation, configuration, and type definitions.