Prerequisites for GenAI Examples

This document contains various prerequisites needed to run the examples in the GenAI Examples repository.

Python Environment

Python v3.11 or v3.12

  • [Recommended] Using Conda: You can use Miniconda to install and manage Python versions.

  • [Alternative] Using Python Installer: You can download the Python installer from Python 3.12.10, select the version appropriate for your operating system, and run the installer.

For Windows, please make sure to check the Add python.exe to PATH option during the installation process.

Access to the Private Binary Version of SDK Library

Google Cloud CLI v493.0.0 or above

  • You can install it by following this instruction.

  • After installing it, sign in to your account using gcloud auth login command.

  • If the gcloud CLI asks you to enter the project ID, enter gdp-labs.

Access to the GDP Labs Google Artifact Registry

  • If you do not have access, please make a request to ticket(at)gdplabs.id.

Access to the Private Source Code Version of SDK Library

Access to GDP-ADMIN/gen-ai-internal repository

  • You can try to access the GDP-ADMIN/gen-ai-internal repository in your browser.

  • If you do not have access, please make a request to ticket(at)gdplabs.id.

Access to GDP-ADMIN/gen-ai-external repository

  • For some examples, you need access to GDP-ADMIN/gen-ai-external.

  • If you do not have access, please make a request to ticket(at)gdplabs.id.

SSH Key in your GitHub Account

Development Environment

VSCode IDE

  • Go to VSCode to download VSCode IDE.

Platform-Specific Requirements

macOS Requirements

If you encounter ImportError: failed to find libmagic on macOS, you can resolve it by:

  • If you have conda installed:

conda install libmagic
cd /usr/local/lib
sudo ln -s /opt/miniconda3/pkgs/libmagic-<version>/lib/libmagic.dylib libmagic.dylib

Please adjust the libmagic version accordingly and please adjust the path of your Conda installation if it differs. In the example above, the path is /opt/miniconda3/.

  • If you have brew installed:

brew install libmagic
Binary SDK Compatibility

The GenAI SDK binary version is currently available for:

  • Linux / WSL: x86_64 architecture.

  • macOS

    • x86_64 (Intel) - macOS version 13 or newer

    • arm64 (Apple Silicon) - macOS version 14 or newer

  • Windows: 64-bit architecture.

Last updated