# googleapis/js-genai

TypeScript/JavaScript SDK for Gemini and Vertex AI.

Repository: https://github.com/googleapis/js-genai
Canonical: https://ross.abutalabs.com/products/js-genai
Homepage: https://googleapis.github.io/js-genai/
Language: TypeScript
License: Apache-2.0
License Family: permissive
Last push: 2026-08-26T19:42:23+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 45
- inputs: {"age_days": 635, "days_push": 7, "days_rel": 8, "gap_med": 5.0, "n_releases_24m": 93}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1668, forks 268 (observed 2026-08-28T04:05:19.749150+00:00)

## What it is
The official Google Gen AI SDK for TypeScript and JavaScript, providing access to the Gemini Developer API and Vertex AI (Gemini Enterprise Agent Platform). It supports Gemini 2.0+ features including content generation, streaming, chats, function calling, and live connections.

## Use cases
- generate text with gemini from node.js
- build a chatbot using the gemini api in typescript
- call vertex ai gemini models from javascript
- stream gemini responses in a web app backend
- implement function calling with gemini
- integrate google ai into a nodejs application

## When to choose
- you are a TypeScript/JavaScript developer building apps on Gemini or Vertex AI
- you need official, up-to-date SDK support for Gemini 2.0+ features
- you want both Gemini Developer API and Google Cloud Vertex AI access from one client

## When to avoid
- you primarily use Python or another language ecosystem
- you need a provider-agnostic LLM client rather than Google-specific APIs
- you must run on Node.js versions older than 20 (22+ in v3.0.0)

## Facets
- artifact type: library
- maturity: active
- function: sdk, llm-inference, agent-framework, http-client
- domain: artificial-intelligence, large-language-models, developer-tools, apis
- platform: cross-platform
- tags: gemini, vertex-ai, google-genai, typescript-sdk, generative-ai, nodejs, web-server

## Member repositories
- googleapis/js-genai (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:19.749150+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:50.002314+00:00, confidence not recorded.
  - readme: https://github.com/googleapis/js-genai (fetched 2026-08-28T04:05:19.749150+00:00, sha d0b5cee72236)
  - homepage: https://googleapis.github.io/js-genai/ (fetched 2026-08-29T11:16:27.120104+00:00, sha 73b824e89910)
- Data as of 2026-08-30T08:39:29.467469+00:00.
