Session

class neptune.sessions.Session(api_token=None, proxies=None)[source]

Bases: object

A class for running communication with Neptune.

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

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

  • proxies (str, optional, default is None) – Argument passed to HTTP calls made via the Requests library. For more information see their proxies section.

Examples

Create session and pass ‘api_token’

from neptune.sessions import Session
session = Session(api_token='YOUR_NEPTUNE_API_TOKEN')

Create session, assuming you have created an environment variable ‘NEPTUNE_API_TOKEN’

from neptune.sessions import Session
session = Session()
get_project(project_qualified_name)[source]

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)[source]

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))
#              ])