neptune-scale

A minimal client library

Apache-2.0 104 个版本 Python <4.0,>=3.9
neptune.ai <contact@neptune.ai>
Documentation
Repository
Tracker
安装
pip install neptune-scale
poetry add neptune-scale
pipenv install neptune-scale
conda install neptune-scale
描述

neptune.ai

Quickstart   •   Website   •   Docs   •   Examples   •   Blog  

Neptune is an experiment tracker purpose-built for foundation model training.

With Neptune, you can monitor thousands of per-layer metrics—losses, gradients, and activations—at any scale. Visualize them with no lag and no missed spikes. Drill down into logs and debug training issues fast. Keep your model training stable while reducing wasted GPU cycles.

Watch a 3min explainer video →  

Play with a live example project in the Neptune app →  

Get started

Neptune consists of a Python API and a web application.

Install the Python client library:

pip install neptune-scale

Configure the API token and project:

  1. Log in to your Neptune workspace.

  2. Get your API token from your user menu in the bottom left corner.

    To create shared API tokens, see how to set up a service account.

  3. In the environment where neptune-scale is installed, save your API token to the NEPTUNE_API_TOKEN environment variable:

    export NEPTUNE_API_TOKEN="h0dHBzOi8aHR0cHM6...Y2MifQ=="

  4. Create a project, or find an existing project you want to send the run metadata to.

    To create a project via API:

    from neptune_scale.projects import create_project

create_project(
    name="project-x",
    workspace="team-alpha",
)

  5. (optional) In the environment where neptune-scale is installed, save your full project path to the NEPTUNE_PROJECT environment variable:

    export NEPTUNE_PROJECT="team-alpha/project-x"

    If you skip this step, you need to pass the project name as an argument each time you start a run.

You're ready to start using Neptune.

For more help with setup, see Get started in the Neptune documentation.

Example usage

Create an experiment:

from neptune_scale import Run


run = Run(experiment_name="MyExperimentName")

Then, call logging methods on the run and pass the metadata as a dictionary.

Log configuration or other simple values with log_configs():

run.log_configs(
    {
        "learning_rate": 0.001,
        "batch_size": 64,
    }
)

Inside a training loop or other iteration, use log_metrics() to append metric values:

# inside a loop
for step in range(100):
    run.log_metrics(
        data={"acc": 0.89, "loss": 0.17},
        step=step,
    )

Upload files:

run.assign_files(
    {
        "dataset/data_sample": "sample_data.csv",
        "dataset/image_sample": "input/images/img1.png",
    }
)

Log series of histograms:

from neptune_scale.types import Histogram


for step in epoch:
    # your training loop

    my_histogram = Histogram(...)

    run.log_histograms(
        histograms={
            "layers/1/activations": my_histogram
        },
        step=step,
    )

To help organize and group runs, apply tags:

run.add_tags(tags=["testing", "data v1.0"])

# To assign the run to groups, apply group tags
run.add_tags(
    tags=["group1", "group2"]
    group_tags=True,
)

When logging is no longer needed, use close() to stop the run:

run.close()

To explore your experiment, open the project in Neptune and navigate to Runs. For an example, see the demo project →

For more instructions, see the Neptune documentation:

Getting help

For help and support, visit our Support Center.

 

People behind Neptune

Created with :heart: by the neptune.ai team →

分类
Development Status :: 4 - Beta Environment :: Console Intended Audience :: Developers Intended Audience :: Science/Research License :: OSI Approved :: Apache Software License Natural Language :: English Operating System :: MacOS Operating System :: Microsoft :: Windows Operating System :: POSIX Operating System :: Unix Programming Language :: Python :: 3 Programming Language :: Python :: 3.10 Programming Language :: Python :: 3.11 Programming Language :: Python :: 3.12 Programming Language :: Python :: 3.13 Programming Language :: Python :: 3.14 Programming Language :: Python :: 3.9 Topic :: Scientific/Engineering :: Artificial Intelligence Topic :: Software Development :: Libraries :: Python Modules
版本列表
0.31.0a2 2026-01-07
0.31.0a1 2026-01-02
0.30.0 2025-11-26
0.29.0 2025-10-23
0.29.0b1 2025-10-22
0.28.0 2025-10-21
0.28.0b1 2025-10-16
0.27.0 2025-09-25
0.27.0b2 2025-09-24
0.27.0b1 2025-09-24
0.26.0 2025-09-24
0.26.0b1 2025-09-15
0.25.1 2025-09-15
0.25.1a1 2025-09-15
0.25.0b2 2025-09-10
0.25.0b1 2025-09-09
0.24.0 2025-09-09
0.24.0b2 2025-09-05
0.24.0b1 2025-09-02
0.23.0 2025-09-02
0.23.0b2 2025-08-28
0.23.0b1 2025-08-28
0.22.0 2025-08-28
0.22.0b2 2025-08-27
0.22.0b1 2025-08-26
0.21.0 2025-08-06
0.21.0b1 2025-08-05
0.20.0 2025-08-05
0.20.0b1 2025-07-30
0.19.0 2025-07-30
0.19.0b1 2025-07-24
0.18.0 2025-07-24
0.18.0b1 2025-07-22
0.17.0 2025-06-26
0.17.0b1 2025-06-24
0.16.0 2025-06-23
0.16.0b0 2025-06-18
0.15.0 2025-06-12
0.15.1b0 2025-06-18
0.14.1 2025-06-11
0.14.0 2025-06-04
0.14.1b3 2025-06-17
0.14.1b2 2025-06-17
0.14.1b1 2025-06-06
0.14.1b0 2025-06-04
0.13.0 2025-05-22
0.13.1b0 2025-05-28
0.13.0b0 2025-05-16
0.12.1 2025-05-19
0.12.0 2025-04-29
0.12.1b1 2025-05-06
0.12.1b0 2025-05-06
0.12.0b5 2025-04-29
0.12.0b4 2025-04-25
0.12.0b3 2025-04-25
0.12.0b2 2025-04-23
0.12.0b1 2025-04-23
0.12.0b0 2025-04-18
0.11.3 2025-04-08
0.11.2 2025-04-03
0.11.1 2025-03-25
0.11.0 2025-03-18
0.11.4b0 2025-04-15
0.11.3b1 2025-04-07
0.11.3b0 2025-04-04
0.11.2b0 2025-04-01
0.11.1b2 2025-03-25
0.11.1b1 2025-03-24
0.11.1b0 2025-03-24
0.11.0b4 2025-03-15
0.11.0b3 2025-03-14
0.11.0b2 2025-03-13
0.11.0b1 2025-03-13
0.11.0b0 2025-03-12
0.10.2 2025-02-25
0.10.1 2025-02-21
0.10.0 2025-02-19
0.10.2b1 2025-02-25
0.10.2b0 2025-02-25
0.10.1b1 2025-02-21
0.10.0b1 2025-02-19
0.9.1 2025-02-13
0.9.0 2025-01-07
0.9.1b2 2025-01-17
0.9.1b1 2025-01-17
0.9.1b0 2025-01-16
0.9.0b0 2025-01-07
0.8.0 2024-11-26
0.8.0b2 2024-11-26
0.8.0b1 2024-11-25
0.8.0b0 2024-11-08
0.7.3 2024-11-08
0.7.2 2024-11-07
0.7.1 2024-10-28
0.7.2b3 2024-11-06
0.7.2b0 2024-11-06
0.7.0b0 2024-10-28
0.6.3 2024-10-23
0.6.2 2024-10-15
0.6.1 2024-10-04
0.6.0 2024-09-09
0.5.0 2024-09-05
0.4.0 2024-09-03
0.3.0 2024-09-03