Skip to main content


Jupyter is an open-source project that supports interactive data science and scientific computing across all programming languages. JupyterHub brings the power of notebooks to groups of users. It gives users access to computational environments and resources without burdening the users with installation and maintenance tasks.

Check out their official website to get started.


Before you start using the driver, you need to connect to the Jupyter instance. In the Naas cloud, you can connect without any argument as it will automatically find your token.

Get your token here: Naas token

Connect to Jupyter instance:

from naas_drivers import jupyter

# Your token
token = "*****"

# Connect to Jupyter
jp = jupyter.connect(token)

Get Info

Get My Profile

You can fetch your profile details using the following method:

# Get profile details
me = jp.get_me()

Admin Operations

Only Naas admin can perform the following operations.

Get Users

Fetch all the users:

# Get all users
users = jp.get_users()

Get One User

Fetch a specific user:

# User email
email = "[email protected]"

# Get the user
user = jp.get_user(email)

Create User

Create a new user:

# User details
email = "[email protected]"
password = "****"

# Create user
user = jp.create_user(email, password)

Get Authorization

Get authorization for a user:

# User email
email = "[email protected]"

# Get authorization
is_authorize = jp.get_authorize_user(email)

Authorize User

Authorize a user:

# User email
email = "[email protected]"
is_authorize = True

# Authorize user
user = jp.change_authorize_user(email, is_authorize)

Check User Active

Check if a user has a running server:

# User email
email = "[email protected]"

# Check user active
active = jp.is_user_active(email)

Change Password

Change the password of a user:

# User details
email = "[email protected]"
newPassword = "*****"

# Change password
user = jp.change_password_user(email, newPassword)

Get Server Uptime

Get server uptime:

# User email
email = "[email protected]"

# Get server uptime
uptime = jp.get_server_uptime(email)

Stop User

Stop a user:

# User email
email = "[email protected]"

# Stop user

Start User

Start a user:

# User email
email = "[email protected]"

# Start user

Restart User

Restart a user:

# User email
email = "[email protected]"

# Restart user

For more information about Jupyter and its API, you can refer to the official Jupyter API documentation.