---
id: aws-cdk-aws-neptune-alpha
version: "2.265.0a0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-neptune-alpha — The CDK Construct Library for AWS::Neptune

License: permissive · Maintenance: active · Downloads: 138.3K/mo

## What it is and what it does

This package is the AWS CDK construct library for Amazon Neptune, a managed graph database service. It provides Python classes to define Neptune database clusters and instances declaratively within AWS CDK infrastructure-as-code projects, handling the underlying CloudFormation resource generation. The package lets you configure cluster topology (writer and replica instances), instance types, parameter groups, IAM authentication, logging to CloudWatch, and networking via VPC security groups—all through high-level Python objects rather than raw CloudFormation templates.

Neptune is optimized for storing and querying highly connected datasets using Apache TinkerPop Gremlin or W3C SPARQL query languages. The construct library abstracts away the complexity of setting up a production-grade graph database by providing sensible defaults (port 8182, VPC requirement, automatic endpoint management) while allowing fine-grained control over performance tuning, monitoring, and access policies. It integrates with the broader AWS CDK ecosystem, so you can combine Neptune constructs with other AWS services in a single deployment.

Use it for:

- Define a Neptune cluster with read replicas and IAM authentication in a CDK stack for a knowledge graph application.
- Configure audit logging and CloudWatch exports for a Neptune cluster to meet compliance and monitoring requirements.
- Set custom parameter groups (e.g., query timeout, audit logging) for Neptune instances via CDK without manual AWS Console configuration.
- Grant an IAM role permissions to connect to a Neptune cluster using the grant_connect() helper method.
- Provision Neptune instances with specific engine versions and parameter group families (1.2, 1.3, 1.4) for version-specific feature support.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides AWS CDK constructs for defining and managing Amazon Neptune graph database clusters and instances in infrastructure-as-code Python.

Yes. This package is worth installing if you are using AWS CDK to manage infrastructure and need to provision Neptune graph databases. It has low install friction, active maintenance, no known vulnerabilities, and a permissive license. The only caveat is that the APIs are marked experimental and subject to breaking changes between versions, so pin your version and review release notes before upgrading.

## Install

pip install aws-cdk-aws-neptune-alpha
uv add aws-cdk-aws-neptune-alpha
poetry add aws-cdk-aws-neptune-alpha

## Installing aws-cdk.aws-neptune-alpha

Before you install: Low friction installation with four stable runtime dependencies (aws-cdk-lib, constructs, jsii, publication). Package is actively maintained with recent releases and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows commercial and private use with attribution; no restrictions on modification or distribution.

Quickstart:

pip install aws-cdk-aws-neptune-alpha

import aws_cdk.aws_neptune_alpha as neptune

cluster = neptune.DatabaseCluster(self, "Database",
    vpc=vpc,
    instance_type=neptune.InstanceType.R5_LARGE
)

Requires Python 3.10 or later; requires an existing AWS VPC to launch Neptune clusters into.

Verify before relying:

- Whether parameter group families (NEPTUNE_1_2, NEPTUNE_1_3, NEPTUNE_1_4) are all currently supported or if some are deprecated.
- Whether the 2-to-3 week stabilization window for auto minor version upgrades is configurable or fixed.
- Current support status for Neptune engine versions 1.2.0.0 and 1.4 series mentioned in the description.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 138.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws cdk neptune database, graph database infrastructure code, aws neptune cluster construct, cdk managed database, neptune iam authentication, graph database provisioning, aws neptune cloudformation, aws-cdk, infrastructure-as-code, graph-database

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-neptune-alpha) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-neptune-alpha/)