@nilskluewer/pi-gcp-agent-platform

Overview

Use Claude and Gemini models through Google Cloud Vertex AI / Gemini Enterprise Agent Platform in pi.

This package contains both Vertex model adapters:

• anthropic-vertex uses Anthropic's AnthropicVertex client for Claude.
• google-vertex uses pi's native Google Vertex provider for Gemini.

The Google Cloud project, location, and Application Default Credentials setup are shared by both providers.

Getting Started

pi install npm:@nilskluewer/pi-gcp-agent-platform
pi
/setup-gemini-vertexai your-project-id eu
/model google-vertex/gemini-3.1-flash-lite

Select Claude in the same session with:

/model anthropic-vertex/claude-opus-5

The legacy /setup-vertexai command remains available as an alias.

Structure

.
├── extensions/
│   └── gcp-agent-platform/
│       ├── index.ts       # shared setup and provider registration
│       └── anthropic.ts    # AnthropicVertex adapter for Claude
├── LICENSE
├── README.md
└── package.json

Setup

Requirements:

• Google Cloud project with the Vertex AI API enabled.
• Claude and/or Gemini models enabled and available in Vertex AI / Gemini Enterprise Agent Platform.
• gcloud installed for Google Application Default Credentials.

Run the setup command in pi:

/setup-gemini-vertexai <google-cloud-project> [location]

Examples:

/setup-gemini-vertexai my-project-id eu
/setup-gemini-vertexai my-project-id global

The command stores the shared project and location in:

~/.pi/agent/gcp-agent-platform.json

It also checks Google Application Default Credentials and can start:

gcloud auth application-default login

Environment variables override the saved setup:

| Name | Description | Default | |------|-------------|---------| | GOOGLE_CLOUD_PROJECT | Google Cloud project ID. | Saved setup value | | ANTHROPIC_VERTEX_PROJECT_ID | Claude-compatible project ID fallback. | Optional | | GCLOUD_PROJECT | Google Cloud project ID fallback. | Optional | | GOOGLE_CLOUD_LOCATION | Vertex region or multi-region. | Saved setup value or eu | | CLOUD_ML_REGION | Region fallback. | Optional | | VERTEX_REGION | Additional region fallback. | Optional |

The package reads the former Anthropic Vertex setup file as a migration fallback, but new configuration is written only to gcp-agent-platform.json.

Endpoints and model availability

| Location | Endpoint | |----------|----------| | global | https://aiplatform.googleapis.com | | eu | EU multi-region Vertex endpoint | | us | US multi-region Vertex endpoint | | other regions | Regional Vertex endpoint |

Model availability depends on the selected location and the Google Cloud project. For example, some Gemini models available on global are not available in eu.

Models

Use any Claude model exposed by pi's Anthropic catalog and available in the project:

/model anthropic-vertex/claude-opus-5
/model anthropic-vertex/claude-sonnet-5
/model anthropic-vertex/claude-opus-4-8

Use any Gemini model exposed by pi's Google Vertex catalog and available in the project:

/model google-vertex/gemini-3.1-flash-lite
/model google-vertex/gemini-3.5-flash

Vertex AI does not support Anthropic's server-side fallbacks request parameter. The Claude adapter removes that Anthropic-only model metadata before sending requests.

Run without installing

pi -e npm:@nilskluewer/pi-gcp-agent-platform

Migration from the standalone packages

Use this package as the single canonical Vertex package. The former standalone Anthropic package is no longer needed in pi settings.

pi remove /path/to/pi-anthropic-vertex-enterprise-agent-platform
pi install npm:@nilskluewer/pi-gcp-agent-platform

pi-vertex-gemini-search is a separate optional web-search extension and is not part of this model package.

License

MIT