google-gemini / gemini-api-quickstart

Get up and running with the Gemini API in under 5 minutes (with Python)

Gemini API Quickstart - Python

This repository contains a simple Python Flask App running with the Google AI Gemini API, designed to get you started building with Gemini's multi-modal capabilities. The app comes with a basic UI and a Flask backend.

Basic request

To send your first API request with the Gemini API Python SDK, make sure you have the right dependencies installed (see installation steps below) and then run the following code:

import os
import google.generativeai as genai

GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")

genai.configure(api_key=GOOGLE_API_KEY)
model = genai.GenerativeModel('gemini-1.5-flash')

chat = model.start_chat(history=[])
response = chat.send_message("In one sentence, explain how AI works to a child.")
# Note that the chat object is temporarily stateful, as you send messages and get responses, you can 
# see the history changing by doing `chat.history`.

print(response.text)

Setup

1. If you don’t have Python installed, install it from Python.org.

2. Clone this repository.

3. Create a new virtual environment:

   • macOS:

     $ python -m venv venv
     $ . venv/bin/activate

   • Windows:

     > python -m venv venv
     > .\venv\Scripts\activate

   • Linux:

     $ python -m venv venv
     $ source venv/bin/activate

4. Install the requirements:

   $ pip install -r requirements.txt

5. Make a copy of the example environment variables file:

   $ cp .env.example .env

6. Add your API key to the newly created .env file or as an environment variable.

7. Run the app:

$ flask run

You should now be able to access the app from your browser at the following URL: http://localhost:5000!