PyPI

neptune-query

1.14.1neptune-ai/neptune-query ↗New releases in your daily digest, changelog included.

Neptune Query is a Python library for retrieving data from Neptune.

Last release 6 months ago
07 Apr 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 19 of 19 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
46 releases · first in 2025

Release timeline

46 releases since 2025

20252026

One column per month.

Releases

1.14.17 Apr 2026
Pg/global search fix by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/226
What's Changed

Pg/global search fix by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/226

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.14.0...1.14.1
Open source →
1.14.09 Mar 2026
## What's Changed * # Add top-level PEP 561 marker for neptune_query by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/224 Full Chang
What's Changed

Add top-level PEP 561 marker for neptune_query by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/224

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.13.0...1.14.0
Open source →

1.12.025 Feb 2026

Optimize table fetches for explicit attribute lists via entries-search projection by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/2

What's Changed

Optimize table fetches for explicit attribute lists via entries-search projection by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/210
Optimize cold start of neptune-query by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/214

New Contributors

@PatrykGala made their first contribution in https://github.com/neptune-ai/neptune-query/pull/210

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.11.0...1.12.0

Open source →

1.12.0b119 Feb 2026pre-release

Optimize table fetches for explicit attribute lists via entries-search projection by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/2

What's Changed

Optimize table fetches for explicit attribute lists via entries-search projection by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/210
Optimize cold start of neptune-query by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/214

New Contributors

@PatrykGala made their first contribution in https://github.com/neptune-ai/neptune-query/pull/210

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.11.0...1.12.0-beta.1

Open source →

1.10.015 Jan 2026

The dependency on neptune-api is dropped. A copy of the neptune-api (version 0.26.0) is bundled in src/neptune_query/generated and code is updated to

What's Changed

The dependency on neptune-api is dropped. A copy of the neptune-api (version 0.26.0) is bundled in src/neptune_query/generated and code is updated to use the new path.

This simplifies the development of neptune-query and allows to pin versions of neptune-query and neptune-scale independently.

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.9.0...1.10.0

Open source →

1.9.012 Jan 2026

Add documentation by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/185

What's Changed

Add documentation by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/185
Bump neptune-api to 0.26 by @gabrys in https://github.com/neptune-ai/neptune-query/pull/186
Remove support for older versions of protobuf

Other Changes

Rewrite e2e tests (@pitercl, @gabrys)
Bump dev dependencies
Fix mypy errors

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.8.0...1.9.0

Open source →

1.8.023 Dec 2025

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121

What's Changed

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121

Internal

Enrich and enable sending the query context to log_query by @gabrys in https://github.com/neptune-ai/neptune-query/pull/158

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.7.0...1.8.0

Open source →

1.8.0b317 Dec 2025pre-release

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121

What's Changed

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121
fix(retrieval): split large attribute filter before fetching attribute definitions by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/122
fix: Require explicit typing in global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/162
feat: Enrich and enable sending the query context to log_query by @gabrys in https://github.com/neptune-ai/neptune-query/pull/158

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.7.0...1.8.0-beta.3

Open source →

1.8.0b216 Dec 2025pre-release

fix: Require explicit typing in global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/162

What's Changed

fix: Require explicit typing in global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/162

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.8.0-beta.1...1.8.0-beta.2

Open source →

1.8.0b126 Nov 2025pre-release

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121

What's Changed

Experimental API for global experiment table search by @pitercl in https://github.com/neptune-ai/neptune-query/pull/121
fix(retrieval): split large attribute filter before fetching attribute definitions by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/122

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.7.0...1.8.0-beta.1

Open source →

1.5.117 Sept 2025

Fix performance regression in fetch_metrics introduced in 1.4.1 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/64

What's Changed

Fix performance regression in fetch_metrics introduced in 1.4.1 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/64

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.5.0...1.5.1

Open source →

1.5.1b117 Sept 2025pre-release

fix(perf, output_format): replace dropna=False+filter with dropna=True+reindex by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/64

What's Changed

fix(perf, output_format): replace dropna=False+filter with dropna=True+reindex by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/64

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.5.0...1.5.1-beta.1

Open source →

1.5.016 Sept 2025

Fix retries in fetch_metric_buckets by @gabrys in https://github.com/neptune-ai/neptune-query/pull/58

What's Changed

Fix retries in fetch_metric_buckets by @gabrys in https://github.com/neptune-ai/neptune-query/pull/58
Fix regression in fetch_metrics by @pitercl in https://github.com/neptune-ai/neptune-query/pull/63
Improve retries UX by @gabrys in https://github.com/neptune-ai/neptune-query/pull/57
Update README.md by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/54

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.4.1...1.5.0

Open source →

1.5.0b216 Sept 2025pre-release

fix regression in fetch_metrics by @pitercl in https://github.com/neptune-ai/neptune-query/pull/63

What's Changed

fix regression in fetch_metrics by @pitercl in https://github.com/neptune-ai/neptune-query/pull/63

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.5.0-beta.1...1.5.0-beta.2

Open source →

1.5.0b115 Sept 2025pre-release

Update README.md for 1.4.1 by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/54

What's Changed

Update README.md for 1.4.1 by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/54
chore: update neptune-api to <0.24.0 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/59
Fix retries for get_timeseries_buckets_proto.sync_detailed by @gabrys in https://github.com/neptune-ai/neptune-query/pull/58
feat: add x_range to fetch_time_series_buckets by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/55
PY-206 Improve retries UX in neptune-query by @gabrys in https://github.com/neptune-ai/neptune-query/pull/57
chore(deps): bump pypa/gh-action-pypi-publish from 1.12.4 to 1.13.0 by @dependabot[bot] in https://github.com/neptune-ai/neptune-query/pull/47
Fix comments in src/neptune_query/internal/warnings.py by @gabrys in https://github.com/neptune-ai/neptune-query/pull/60

New Contributors

@dependabot[bot] made their first contribution in https://github.com/neptune-ai/neptune-query/pull/47

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.4.1...1.5.0-beta.1

Open source →

1.4.111 Sept 2025

New experimental API method: fetch_metric_buckets by @michalsosn, @gabrys, @pitercl in https://github.com/neptune-ai/neptune-query/pull/46

What's Changed

New experimental API method: fetch_metric_buckets by @michalsosn, @gabrys, @pitercl in https://github.com/neptune-ai/neptune-query/pull/46

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.3.0...1.4.1

Open source →

1.4.1b19 Sept 2025pre-release

chore: add inf/nan handling by @pitercl in https://github.com/neptune-ai/neptune-query/pull/20

What's Changed

chore: add inf/nan handling by @pitercl in https://github.com/neptune-ai/neptune-query/pull/20
Bump neptune-api to 0.22.0 by @gabrys in https://github.com/neptune-ai/neptune-query/pull/36
feat: fetch_metrics_buckets by @michalsosn, @gabrys, @pitercl

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.3.0...1.4.1-beta.1

Open source →

1.4.1a15 Sept 2025pre-release

chore: add inf/nan handling by @pitercl in https://github.com/neptune-ai/neptune-query/pull/20

What's Changed

chore: add inf/nan handling by @pitercl in https://github.com/neptune-ai/neptune-query/pull/20
Bump neptune-api to 0.22.0 by @gabrys in https://github.com/neptune-ai/neptune-query/pull/36
feat: fetch_metrics_buckets by @michalsosn, @gabrys, @pitercl

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.3.0...1.4.1-alpha.1

Open source →

1.3.02 Sept 2025

feat: download files from s3 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/10

What's Changed

feat: download files from s3 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/10
Improve the error message in NeptuneRetryError by @gabrys in https://github.com/neptune-ai/neptune-query/pull/11

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.2.2...1.3.0

Open source →

1.3.0b128 Aug 2025pre-release

feat: download files from s3 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/10

What's Changed

feat: download files from s3 by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/10
Improve the error message in NeptuneRetryError by @gabrys in https://github.com/neptune-ai/neptune-query/pull/11

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.2.2...1.3.0-beta.1

Open source →

1.2.125 Aug 2025

Bump default soft/hard retry timeouts to 1800/3600 seconds by @gabrys in https://github.com/neptune-ai/neptune-query/pull/17

What's Changed

Bump default soft/hard retry timeouts to 1800/3600 seconds by @gabrys in https://github.com/neptune-ai/neptune-query/pull/17
fix references to experiments in runs.py by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/16

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.2.0...1.2.1

Open source →

1.2.025 Aug 2025

chore: cleanup tests by @pitercl in https://github.com/neptune-ai/neptune-query/pull/12

What's Changed

chore: cleanup tests by @pitercl in https://github.com/neptune-ai/neptune-query/pull/12
fix: fix Index contains duplicate entries, cannot reshape by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/15
fix: lineage to the root respects experiment by @pitercl in https://github.com/neptune-ai/neptune-query/pull/14
README: Update version in install command by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/13

New Contributors

@michalsosn made their first contribution in https://github.com/neptune-ai/neptune-query/pull/15
@normandy7 made their first contribution in https://github.com/neptune-ai/neptune-query/pull/13

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.1.0...1.2.0

Open source →

1.2.0b125 Aug 2025pre-release

chore: cleanup tests by @pitercl in https://github.com/neptune-ai/neptune-query/pull/12

What's Changed

chore: cleanup tests by @pitercl in https://github.com/neptune-ai/neptune-query/pull/12
fix: fix Index contains duplicate entries, cannot reshape by @michalsosn in https://github.com/neptune-ai/neptune-query/pull/15
fix: lineage to the root respects experiment by @pitercl in https://github.com/neptune-ai/neptune-query/pull/14
README: Update version in install command by @normandy7 in https://github.com/neptune-ai/neptune-query/pull/13

New Contributors

@michalsosn made their first contribution in https://github.com/neptune-ai/neptune-query/pull/15
@normandy7 made their first contribution in https://github.com/neptune-ai/neptune-query/pull/13

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.1.0...1.2.0-beta.1

Open source →

1.1.019 Aug 2025

Move neptune-query to a new repository https://github.com/neptune-ai/neptune-query/

What's Changed

Move neptune-query to a new repository https://github.com/neptune-ai/neptune-query/
download_files by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/387
Guess file extension by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/394
Send additional debug information in API calls by @pitercl in https://github.com/neptune-ai/neptune-fetcher/pull/389
Update docstrings for neptune-query by @normandy7 in https://github.com/neptune-ai/neptune-fetcher/pull/391
Fix up docs for neptune-query by @normandy7 in https://github.com/neptune-ai/neptune-fetcher/pull/397
Assume types for known sys attributes by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/372
Remove pre-optimization in fetching attribute definitions by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/398
Remove mentions of set_context and set_project from exceptions by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/409
Improve the UX of download_files by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/402
Rename envs from NEPTUNE_FETCHER_* to NEPTUNE_QUERY_* by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/412
Bump default NEPTUNE_QUERY_MAX_WORKERS to 32 by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/413
Change type inference in neptune-query for better UX by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/406

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/1.0.0...1.1.0

Open source →

1.1.0b418 Aug 2025pre-release

Move neptune-query to a new repository https://github.com/neptune-ai/neptune-query/

What's Changed

Move neptune-query to a new repository https://github.com/neptune-ai/neptune-query/
download_files by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/387
Guess file extension by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/394
Send additional debug information in API calls by @pitercl in https://github.com/neptune-ai/neptune-fetcher/pull/389
Update docstrings for neptune-query by @normandy7 in https://github.com/neptune-ai/neptune-fetcher/pull/391
Fix up docs for neptune-query by @normandy7 in https://github.com/neptune-ai/neptune-fetcher/pull/397
Assume types for known sys attributes by @michalsosn in https://github.com/neptune-ai/neptune-fetcher/pull/372
Remove pre-optimization in fetching attribute definitions by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/398
Remove mentions of set_context and set_project from exceptions by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/409
Improve the UX of download_files by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/402
Rename envs from NEPTUNE_FETCHER_* to NEPTUNE_QUERY_* by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/412
Bump default NEPTUNE_QUERY_MAX_WORKERS to 32 by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/413
Change type inference in neptune-query for better UX by @gabrys in https://github.com/neptune-ai/neptune-fetcher/pull/406

Full Changelog: https://github.com/neptune-ai/neptune-query/compare/neptune_query/1.0.0...1.1.0-beta.4

Open source →

1.0.017 Jul 2025

> _Note that the Neptune Query API is different from Neptune Fetcher._

Initial release of `neptune_query`

Note that the Neptune Query API is different from Neptune Fetcher.

Notable changes compared to neptune_fetcher:

Name of the module changed from neptune_fetcher.alpha to neptune_query
Removal of the old API (ReadOnlyProject, ReadOnlyRun)
File representation is changing in fetch_runs_table and fetch_experiments_table
Revamp APIs of Filter and AttributeFilter
Revamp APIs of experiments, runs, and attributes parameters to the public functions
Support extended regex syntax for selecting runs, experiments and attributes
Support retrieval of file series
Support retrieval of histogram series
Remove support for float series aggregations (only last logged value is returned)
Require at least Python 3.10

Full changelog: https://github.com/neptune-ai/neptune-query/compare/0.18.0...1.0.0

Open source →

neptune-query

Release timeline

Releases

What's Changed

What's Changed

Add top-level PEP 561 marker for neptune_query by @PatrykGala in https://github.com/neptune-ai/neptune-query/pull/224

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

Other Changes

What's Changed

What's Changed

What's Changed

Internal

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

New Contributors

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

What's Changed

New Contributors

What's Changed

New Contributors

What's Changed

What's Changed

Initial release of neptune_query

Initial release of `neptune_query`