Skip to content

InfuseAI/primehub-python-sdk

Repository files navigation

PrimeHub Python SDK

PrimeHub Python SDK is the PrimeHub AI Platform Software Development Kit (SDK) for Python, which allows Python developers to write software that makes use of services like Job and Deployment.

Getting Started

Assuming that you have Python, you can install the library using pip:

$ pip install primehub-python-sdk

Or trying the latest from our source code:

$ pip install git+https://github.com/InfuseAI/primehub-python-sdk.git@main

Using CLI

After installing PrimeHub Python SDK

Next, set up the configuration in ~/.primehub/config.json:

{
  "api-token": "<api-token>",
  "endpoint": "https://<primehub-domain>/api/graphql",
  "group": {
    "name": "<group-name>"
  }
}

The <api-token> could be generated from User Portal.

Then, from a shell:

$ primehub me
id:             a7db12dc-04fa-419c-9cd7-af768575a871
username:       phadmin
firstName:      None
lastName:       None
email:          [email protected]
isAdmin:        True

Running primehub without arguments to show help:

$ primehub
Usage:
  primehub <command>

Available Commands:
  admin                Commands for system administrator
  apps                 Manage PrimeHub Applications
  apptemplates         Get PhAppTemplates
  config               Update the settings of PrimeHub SDK
  datasets             Manage datasets
  deployments          Get a deployment or list deployments
  files                List and download shared files
  groups               Get a group or list groups
  images               Get a image or list images
  info                 Display the user information and the selected group information
  instancetypes        Get an instance types of list instance types
  jobs                 Manage jobs
  me                   Show user account
  models               Manage models
  notebooks            Get notebooks logs
  recurring-jobs       Manage recurring jobs
  version              Display the version of PrimeHub Python SDK
  volumes              Get a volume or list volumes

Options:
  -h, --help           Show the help

Global Options:
  --config CONFIG      Change the path of the config file (Default: ~/.primehub/config.json)
  --endpoint ENDPOINT  Override the GraphQL API endpoint
  --token TOKEN        Override the API Token
  --group GROUP        Override the current group
  --json               Output the json format (output human-friendly format by default)

SDK

from a Python interpreter:

In [1]: from primehub import PrimeHub, PrimeHubConfig

In [2]: ph = PrimeHub(PrimeHubConfig())

In [3]: ph.me.me()
Out[3]:
{'id': 'a7db12dc-04fa-419c-9cd7-af768575a871',
 'username': 'phadmin',
 'firstName': None,
 'lastName': None,
 'email': '[email protected]',
 'isAdmin': True}

In [4]:

Docs

There is a docs folder in our repository. You could find:

  • CLI: all commands usage examples
  • notebook: examples written in python