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)

Namespace#

A namespace is a way to group multiple workspaces and their data sets. 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:

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

To change the active namespace, use:

$ hs namespace use org

Workspaces#

Intents are kept within workspaces, if you have created a workspace already, you can locate its id using hf workspace list.

Example:

$ hf workspace list
id name disabled
playbook-Z6T2R76YXJB65LA62CHOTTPT rasa false

If not, you can create one with hf workspace create [name]

Example:

$ hf workspace create namehere
Created: playbook-W3WG4KTBIJFNZA357GTKJTD4