---
id: mypy-boto3-neptune
version: "1.43.28"
license: MIT
license_treatment: permissive
maintenance: active
---

# mypy-boto3-neptune — Type annotations for boto3 Neptune 1.43.28 service generated with mypy-boto3-builder 8.12.0

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

## What it is and what it does

This package is a type stub library that adds static type checking and IDE autocomplete to boto3's Neptune database service. It is generated from boto3 1.43.28 and works with VSCode, PyCharm, Emacs, Sublime Text, mypy, pyright, and other tools that understand Python type annotations. The stubs enable your IDE and type checker to understand Neptune client methods, paginators, and waiters without requiring explicit type annotations in your code.

The package is designed as a development-time dependency—you install it in your environment to get type checking and autocomplete, but it's not needed at runtime. It supports Python 3.9 through 3.14 and depends only on typing-extensions. The documentation notes that PyCharm users may experience performance issues with the full version and recommends using boto3-stubs-lite as an alternative.

Use it for:

- Enable IDE autocomplete and type checking for Neptune client calls in VSCode with Pylance
- Run mypy or pyright type checking on code using boto3 Neptune without manual type annotations
- Get real-time code completion for Neptune paginators and waiters in PyCharm or other IDEs
- Catch Neptune API usage errors at development time rather than runtime
- Use TYPE_CHECKING guards to avoid runtime dependencies while keeping full type support

## Worth the install?

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

Provides type annotations and IDE autocomplete support for boto3's Neptune service, enabling static type checking with mypy, pyright, and other tools.

Yes, if you use boto3 with Neptune and want IDE support or static type checking. Install friction is minimal (one dependency, pure Python), maintenance is active, and the MIT license has no restrictions. PyCharm users should be aware of potential performance issues with Literal overloads and may prefer boto3-stubs-lite instead.

## Install

pip install mypy-boto3-neptune
uv add mypy-boto3-neptune
poetry add mypy-boto3-neptune

## Installing mypy-boto3-neptune

Before you install: Low friction: single runtime dependency (typing-extensions), pure Python wheel, actively maintained with recent releases. Repository shows 670 stars and last commit on 2026-06-22.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal attribution requirements.

Quickstart:

python -m pip install mypy-boto3-neptune

from boto3.session import Session
from mypy_boto3_neptune import NeptuneClient

client: NeptuneClient = Session().client("neptune")

Requires Python 3.9 or later; boto3 must be installed separately

Verify before relying:

- Whether PyCharm performance issues with Literal overloads (PY-40997) remain unresolved
- Compatibility guarantees with boto3 versions beyond 1.43.28

## Package facts

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

## Tags

boto3 type stubs neptune, type annotations aws neptune, mypy boto3 neptune, neptune client type hints, boto3 neptune autocomplete, pyright boto3 stubs, ide support neptune aws, type-stubs, aws-sdk, ide-support

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