Command Line Tool

A command-line tool named hf is available to better integrate with conversational AI platforms and to automate certain actions like importing new conversations or utterance data.

Download#

You can download the latest version of the hf binary here.

Authenticating#

hf auth login [email] will locally prompt for your password and keep you logged in for future commands.

The local state is saved in ~/.config/humanfirst/config.yaml

Example:

$ hf auth login [email protected]
Password:
Authenticated as [email protected] (org=example uid=ABCDEFGHIJ)

Namespaces#

A namespace is a way to group multiple workspaces and their datasets and is required when using our API.

You cannot create a namespace by yourself, but you can contact us to create one for you.

To list the namespaces you have access to, use:

$ hf namespace list
active name display_name organization
* org org
org-ns2 ns2 org

To change the active namespace, use:

$ hf namespace --ns org use
Namespace set to: org