grafeas
Grafeas API client library
What it is and what it does
Grafeas is Google's official Python client for the Grafeas API, an implementation that stores and enables querying of critical metadata about software artifacts. It wraps the Container Analysis service on Google Cloud Platform, allowing developers to programmatically access, query, and retrieve artifact metadata. The library is built on standard Google Cloud infrastructure (google-api-core, google-auth, grpcio, proto-plus, protobuf) and integrates with gRPC for communication.
The package is intended for developers working with Google Cloud who need to interact with artifact metadata at scale—for example, querying vulnerability data, build provenance, or deployment information about container images and other software artifacts. It requires Python 3.10 or later and assumes the user has a Google Cloud project with Container Analysis enabled and proper authentication configured.
Use it for:
- Query vulnerability and security metadata for container images stored in Google Cloud.
- Retrieve build provenance and deployment information about software artifacts.
- Integrate artifact metadata queries into CI/CD pipelines for compliance and auditing.
- Programmatically access critical metadata about all software artifacts in a project.
- Build custom dashboards or tools that analyze artifact metadata from Container Analysis.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Python client library for the Grafeas API, enabling querying and retrieval of software artifact metadata stored in Google Cloud's Container Analysis service.
Yes, if you are working with Google Cloud Container Analysis. The library is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and has no known vulnerabilities. It is the official client for the Grafeas API and is necessary to interact with Container Analysis metadata from Python. Not relevant if you are not using Google Cloud or Container Analysis.
Install
grafeas on PyPI
pip
pip install grafeasuv
uv add grafeaspoetry
poetry add grafeasInstalling grafeas
Before you install
Low install friction with a pure-wheel distribution. Actively maintained with a release 8 days old and recent commits. Depends on standard Google Cloud libraries (google-api-core, google-auth, grpcio, proto-plus, protobuf).
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install grafeas
from google.cloud import grafeas_v1
client = grafeas_v1.GrafeasClient()
# Query metadata from Container Analysis
Requires Python >= 3.10 and Google Cloud authentication credentials configured (via GOOGLE_APPLICATION_CREDENTIALS or Application Default Credentials).
Verify before relying
- Whether the library supports offline use or requires active Google Cloud connectivity for all operations.
- Performance characteristics when querying large volumes of artifact metadata.
- Whether Container Analysis API must be explicitly enabled in a Google Cloud project before use.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 5 — google-api-core, google-auth, grpcio, proto-plus, protobuf |
| Maintenance | actively maintained — 8 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 431,957/month — #6,712 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: grafeas-1.24.0-py3-none-any.whl
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
google-cloud-containeranalysisPython client library for Google Cloud…
permissive · top 15,000 on PyPI
google-cloud-artifact-registryPython client library for Google Cloud Artifact…
permissive · top 5,000 on PyPI
google-cloud-containerProvides a Python client library for…
permissive · top 1,000 on PyPI
google-cloud-resource-managerProvides a Python client for Google Cloud…
permissive · top 1,000 on PyPI
google-cloud-bigquery-storageProvides a Python client library for reading…
permissive · top 1,000 on PyPI
google-analytics-dataPython client library for querying Google…
permissive · top 5,000 on PyPI
google-cloud-monitoringPython client library for Google Cloud…
permissive · top 1,000 on PyPI
google-cloud-filestorePython client library for creating and managing…
permissive · top 15,000 on PyPI
google-cloud-billingProgrammatic access to Google Cloud Platform…
permissive · top 15,000 on PyPI
google-cloud-bigquery-loggingPython client library for Google Cloud BigQuery…
permissive · top 15,000 on PyPI