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.


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


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


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


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