Nodestream

Nodestream Logo

A Declarative framework for Building, Maintaining, and Analyzing Graph Data 🚀

Continuous Integration codecov ApacheV2 License

All Contributors

Nodestream allows you to work with graphs declaratively. With nodestream, you unlock a bounty of features purpose built for working with graphs. Semantically model your graph and map labels and properties directly to your data. Better yet, you are not locked into your choices. Nodestream works with you as you evolve your application by providing migration utilities to change your data schema. Nodestream even decouples you from the underyling database technology so you can even change databases.

Highlights

  • Connect to data sources like Kafka, files, apis, and more!
  • Evolve your application over time with database migrations (Docs)
  • Use your favorite Graph Database to fit any tech stack (Docs)
  • Clean up your own data with TTLs (Docs)
  • Infinite Customizability Since Nearly Everything is Pluggable!

Website • Blog • Discussions • Contributing • Contributing Developer Guides • Talks from Maintainers

Features

Nodestream has a pleasant CLI interface to get new projects up and running fast.

Demo

Not a fan of the defaults? You can change out databases very easily

Using Another Database

Then you can start to model your data and nodestream will evolve your database for you. No more messing with constraints or writing database queries.

Running Migrations

Getting Started

Conviced? Install nodestream with pip to get started.

  pip install nodestream
  nodestream new --database neo4j my_project && cd my_project
  nodestream run sample -v

We highly recommend following our tutorials here

Packages

Nodestream is built on a Highly Pluggable and Modular Architecture. Thus... we have a lot of packages to keep track of.

Package Description Version
nodestream The core library. Declarative ingestion. PyPI Version
nodestream-plugin-neo4j Neo4j database connector. PyPI Version
nodestream-plugin-neptune AWS Neptune database connector. PyPI Version
nodestream-plugin-dotenv Adds DotEnv integration. PyPI Version
nodestream-plugin-pedantic A series of lints to enforce reasonable naming standards, etc. PyPI Version
nodestream-plugin-shell An integration with nodestream to run shell commands. PyPI Version
nodestream-plugin-sbom Import SBOM files in CycloneDX and SPDX into an opinionated graph data model. PyPI Version
nodestream-plugin-akamai Parse Akamai properties, redirect configs, and much more and ingests them. PyPI Version
nodestream-plugin-k8s In incubation. A plugin that orchestrates Nodestream on k8s. PyPI Version

Contributors

Nodestream is a community project. We welcome all contributions. Be sure to checkout or Contributing Docs and our Code of Conduct before contributing.

Zach Probst
Zach Probst
💻 👀 🚧		 Chad Cloes
Chad Cloes
💻 👀 🚧		 asantos4
asantos4
💻 👀 🚧		 Grant Hoffman
Grant Hoffman
💻 👀		 khneal
khneal
💻		 orozen
orozen
💻		 Sophia Don Tranho
Sophia Don Tranho
💻
bechbd
bechbd
💻		 yasonk
yasonk
💻 👀		 Stuart Macleod
Stuart Macleod
💻		 Cole Greer
Cole Greer
💻		 Austin Lucas
Austin Lucas
💻		 rreddy2
rreddy2
💻		 Jon Bristow
Jon Bristow
💻
Add your contributions

Contributing

Need a quick reference guide on how to contribute? Here you go!

Getting Setup

To get started you'll need to install poery.

curl -sSL https://install.python-poetry.org | python3 -

You then can install the project dependencies with the following command:

poetry install

No need to active a virtual environment. Poetry handles that for you with poetry run and poetry shell.

Running Tests

To run tests for the entire project, run the following command:

poetry run pytest

Project links

Data verified by PyPI on Jun 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.16.1)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Zach Probst

GitHub Statistics

Data verified by PyPI on Jun 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Affero General Public License v3, GNU General Public License v3 (GPLv3) (GPL-3.0-only)

Requires

Python <4.0, >=3.10

Provides Extra

prometheus validation

Tags

etl neo4j declarative data kafka ingest

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nodestream-0.16.0.tar.gz (127.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nodestream-0.16.0-py3-none-any.whl (189.1 kB view details)

Uploaded Python 3

File details

Details for the file nodestream-0.16.0.tar.gz.

File metadata

  • Download URL: nodestream-0.16.0.tar.gz
  • Upload date:
  • Size: 127.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for nodestream-0.16.0.tar.gz
Algorithm Hash digest
SHA256 bdcf0b52ba69c95ff85147c1c27a3af82f56ee37495ff2b56126b33b5f07c94c
MD5 b33a0f26311307c03db0b309c9519d3f
BLAKE2b-256 5c0ca780aa939193d70fcd4a8ccace0818de39c7bf3d387b54e17b3990ddc133

See more details on using hashes here.

Provenance

The following attestation bundles were made for nodestream-0.16.0.tar.gz:

Publisher: release.yaml on nodestream-proj/nodestream

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nodestream-0.16.0-py3-none-any.whl.

File metadata

  • Download URL: nodestream-0.16.0-py3-none-any.whl
  • Upload date:
  • Size: 189.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for nodestream-0.16.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5836aeca6dbef93755c1a1231f4d4e3ae205a3adca8f5a0c5b312169ba0de457
MD5 27e091e316e448006408e17d2ff76e27
BLAKE2b-256 92ad50264b651aece25484f8edfba6d8ffc3d90d638a594f58fcee8ff5648de4

See more details on using hashes here.

Provenance

The following attestation bundles were made for nodestream-0.16.0-py3-none-any.whl:

Publisher: release.yaml on nodestream-proj/nodestream

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.16.1

2 files

This release

0.16.0 This release

2 files

0.15.3

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

Pre-release

0.15.0a2

2 files

Pre-release

0.15.0a1

2 files

Pre-release

0.15.0a0

2 files

0.14.17

2 files

0.14.16

2 files

0.14.15

2 files

0.14.14

2 files

0.14.13

2 files

0.14.12

2 files

0.14.11

2 files

0.14.10

2 files

0.14.9

2 files

0.14.8

2 files

0.14.7

2 files

0.14.6

2 files

0.14.5

2 files

0.14.4

2 files

0.14.3

2 files

0.14.0

2 files

0.13.8

2 files

0.13.7

2 files

0.13.6

2 files

0.13.5

2 files

0.13.4

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

Pre-release

0.13.0b1

2 files

Pre-release

0.13.0a1

2 files

Pre-release

0.12.5a14

2 files

Pre-release

0.12.5a13

2 files

Pre-release

0.12.5a12

2 files

Pre-release

0.12.5a11

2 files

Pre-release

0.12.5a10

2 files

Pre-release

0.12.5a9

2 files

Pre-release

0.12.5a8

2 files

Pre-release

0.12.5a7

2 files

Pre-release

0.12.5a6

2 files

Pre-release

0.12.5a5

2 files

Pre-release

0.12.5a4

2 files

Pre-release

0.12.5a3

2 files

Pre-release

0.12.5a2

2 files

Pre-release

0.12.5a1

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.1

2 files

Yanked

0.12.0

2 files

Yanked reason: Missing default args

Pre-release

0.12.0rc2

2 files

Pre-release

0.12.0rc1

2 files

Pre-release

0.12.0a3

2 files

Pre-release

0.12.0a2

2 files

Pre-release

0.12.0a1

2 files

0.11.12

2 files

0.11.11

2 files

Pre-release

0.11.11a0

2 files

0.11.10

2 files

0.11.9

2 files

0.11.8

2 files

0.11.7

2 files

0.11.6

2 files

0.11.5

2 files

0.11.4

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.8

2 files

0.10.7

2 files

0.10.6

2 files

0.10.5

2 files

0.10.4

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.20

2 files

0.8.19

2 files

0.8.18

2 files

0.8.17

2 files

0.8.16

2 files

0.8.15

2 files

0.8.14

2 files

0.8.13

2 files

0.8.12

2 files

0.8.11

2 files

0.8.10

2 files

0.8.9

2 files

0.8.8

2 files

0.8.7

2 files

0.8.6

2 files

0.8.5

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

Yanked

0.8.0

2 files

Yanked reason: Critical bug

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page