Session

class neptune.sessions.Session(api_token=None, proxies=None, backend=None)

Bases: object

A class for running communication with Neptune.

In order to query Neptune experiments you need to instantiate this object first.

Parameters

• backend (Backend, optional, default is None) –

  By default, Neptune client library sends logs, metrics, images, etc to Neptune servers: either publicly available SaaS, or an on-premises installation.

  You can pass the default backend instance explicitly to specify its parameters:

  from neptune import Session, HostedNeptuneBackend
  session = Session(backend=HostedNeptuneBackend(...))
  

  Passing an instance of OfflineBackend makes your code run without communicating with Neptune servers.

  from neptune import Session, OfflineBackend
  session = Session(backend=OfflineBackend())
  

• api_token (str, optional, default is None) –

  User’s API token. If None, the value of NEPTUNE_API_TOKEN environment variable will be taken. Parameter is ignored if backend is passed.

  Deprecated since version 0.4.4.

  Instead, use:

  from neptune import Session
  session = Session.with_default_backend(api_token='...')
  

• proxies (str, optional, default is None) –

  Argument passed to HTTP calls made via the Requests library. For more information see their proxies section. Parameter is ignored if backend is passed.

  Deprecated since version 0.4.4.

  Instead, use:

  from neptune import Session, HostedNeptuneBackend
  session = Session(backend=HostedNeptuneBackend(proxies=...))
  

Examples

Create session, assuming you have created an environment variable NEPTUNE_API_TOKEN

from neptune import Session
session = Session.with_default_backend()

Create session and pass api_token

from neptune import Session
session = Session.with_default_backend(api_token='...')

Create an offline session

from neptune import Session, OfflineBackend
session = Session(backend=OfflineBackend())

get_project(project_qualified_name)

Get a project with given project_qualified_name.

In order to access experiments data one needs to get a Project object first. This method gives you the ability to do that.

Parameters

project_qualified_name (str) – Qualified name of a project in a form of namespace/project_name.

Returns

Project object.

Raise:

ProjectNotFound: When a project with given name does not exist.

Examples

# Create a Session instance
from neptune.sessions import Session
session = Session()

# Get a project by it's ``project_qualified_name``:
my_project = session.get_project('namespace/project_name')

get_projects(namespace)

Get all projects that you have permissions to see in given organization

This method gets you all available projects names and their corresponding Project objects.

Both private and public projects may be returned for the organization. If you have role in private project, it is included.

You can retrieve all the public projects that belong to any user or organization, as long as you know their username or organization name.

Parameters

namespace (str) – It can either be name of the organization or username.

Returns

OrderedDict

keys are project_qualified_name that is: ‘organization/project_name’

values are corresponding Project objects.

Raises

NamespaceNotFound – When the given namespace does not exist.

Examples

# create Session
from neptune.sessions import Session
session = Session()

# Now, you can list all the projects available for a selected namespace.
# You can use `YOUR_NAMESPACE` which is your organization or user name.
# You can also list public projects created by other organizations.
# For example you can use the `neptune-ml` namespace.

session.get_projects('neptune-ml')

# Example output:
# OrderedDict([('neptune-ml/credit-default-prediction',
#               Project(neptune-ml/credit-default-prediction)),
#              ('neptune-ml/GStore-Customer-Revenue-Prediction',
#               Project(neptune-ml/GStore-Customer-Revenue-Prediction)),
#              ('neptune-ml/human-protein-atlas',
#               Project(neptune-ml/human-protein-atlas)),
#              ('neptune-ml/Ships',
#               Project(neptune-ml/Ships)),
#              ('neptune-ml/Mapping-Challenge',
#               Project(neptune-ml/Mapping-Challenge))
#              ])

classmethod with_default_backend(api_token=None)

The simplest way to instantiate a Session.

Parameters

api_token (str) – User’s API token. If None, the value of NEPTUNE_API_TOKEN environment variable will be taken.

Examples

from neptune import Session
session = Session.with_default_backend()