Skip to main content

Train NLU Models using AutoNLP

Open In Collab Run in Postman

To train NLU models on the NeuralSpace platform you don't need any machine learning knowledge. In this article we will learn how to train our models.


  • Getting Started: Make sure to follow Getting Started to login and install nlu app. If you are using APIs, save your authorization token in a variable called AUTHORIZATION_TOKEN before moving ahead.
  • Create a Project:
    • Make sure to create a project and have the project id in a variable called PROJECT_ID.
    • Make sure to have the language for which you added training examples in a variable called LANGUAGE.
  • Add training data: Make sure to have at least two intents with 10 examples each

Train Model

To train a model using the CLI, use the following command. It will launch a train job and return a unique model id. This model id can be used to monitor the training status of this job.

neuralspace nlu train -p $PROJECT_ID -L "en" -m "My First Model"
--projectId or -ptruestrSet to the id of the project you want the model to be in.
--language or -LtruestrSet to the language of the project
--model-name or -mfalsestrSet to the name you want to give the model
--wait or -wfalsestrSet to true if you wish to wait for training to get completed.
--wait-interval or -ifalseintSet to how long (in seconds) to wait between each poll to check the status of training.

Store this returned model id in a variable.


Every time you call a train job for a given project and language a new model id gets generated. The total number of training jobs you can queue at a time is equal to the number of trained models left in your subscription.

Get Model Status

After calling the train job, a new model id is generated. You can use this id to track your training progress as well as fetch model related attributes.

neuralspace nlu model-status -m $MODEL_ID
InitiatedA training job has been created but not yet queued. Only jobs which are valid get queued in the training pipeline.
QueuedQueued jobs are ready for training. If you are a free plan user then your jobs have the lowest priority. Jobs by basic plan users get a higher priority than free plan users. Advanced plan users always get the highest priority.
Pipeline BuildingOur AutoNLP pipeline is getting built based on the data in your project.
Pipeline BuiltAutoNLP pipeline built and is ready to execute.
Preparing DataOur secret sauce gets poured on your data here.
Data PreparedYour data is ready for training.
TrainingAutoNLP has started training.
TrainedAutoNLP trained successfully.
SavedModel artifacts saved in our secure cloud storage.
CompletedModel is ready to be deployed.
FailedTraining failed. Reason for training can be found in the message attribute of the model object.
Timed OutWe have a hard time-out of 6 hours set for all NLU models. If a model takes longer than that, we cancel the job. This occurs rarely and only when our platform is overloaded.
DeadTraining jobs which have not updated their status for more than 10 hours are declared dead. This means they are not responding. This is also a rare event and happens only when our platform is overloaded.

Once a model's trainingStatus becomes Completed then only its ready for deployment.


Only models with status Completed, Failed, Timed Out, Dead can be deleted.

List Models

You can also list all your projects within a single project.
Read about how to list all your projects in this article.

neuralspace nlu list-models -p $PROJECT_ID -L "en"

Get Single Model

Use this API to fetch a single model and its attributes.


curl --location --request GET "${MODEL_ID}" \
--header "Authorization: ${AUTHORIZATION_TOKEN}"

This will return a json object in the following format

Model Details
"success": true,
"message": "Model status fetched",
"data": {
"name": "...",
"appType": "nlu",
"projectId": "...",
"apikey": "...",
"createdBy": {
"email": "...",
"role": "provider",
"apikey": "...",
"referenceKey": "..."
"active": true,
"status": "active",
"createdAt": 1620059929722,
"updatedAt": 1620059929722,
"modelId": "...",
"replicas": 0,
"trainingStatus": "Completed",
"lastStatusUpdateAt": "2021-05-04T09:28:45.672Z",
"trainingProgress": [
"Pipeline Building",
"Pipeline Built",
"Preparing Data",
"Data Prepared",
"examplesPerIntent": {
"metrics": {
"intentClassifierPerformance": {
"i_acc": 0.9894935488700867,
"i_f1": 0.9894935488700867
"nerPerformance": {
"e_acc": 0.971139669418335,
"e_f1": 0.971139669418335
"language": ".."
"timestamp": 1620120623094

Description of Fields

nameName of the model.
appTypeThis will always be nlu.
projectIdThe id of the project this model belongs to.
apikeyYour API Key
createdAtTimestamp of when this model was created.
updatedAtTimestamp of when this model was updated.
modelIdA unique id for your model.
replicasThis indicates how many replicas of this model is deployed on our platform. Multiple replicas ensue higher throughput and higher availability.
trainingStatusThe current training status.
lastStatusUpdateAtDuring training, whenever the status changes this field is updated with a timestamp.
trainingProgressA list of all training statuses this model has gone through.
examplesPerIntentThis is the distribution of your training dataset. Keys in this dictionary are intents and values are the number of examples you have in the training set for that intent.
metricsWhen you have test examples in a project, the model is evaluated on them. Here you will find some metrics that we calculate to gauge the performance of the model. These numbers are all zeros if you don't upload any test examples.
metrics.intentClassifierPerformanceThese are the metrics for the intent classifier.
metrics.intentClassifierPerformance.i_accThe fraction of test examples for which AutoNLP predicted the right intent.
metrics.intentClassifierPerformance.i_f1[For advanced users only] This is the macro averaged F1 score
metrics.nerPerformanceThese are the metrics for entity recognition.
metrics.nerPerformance.e_accThe fraction of entities for which AutoNLP predicted the right intent.
metrics.nerPerformance.e_f1[For advanced users only] The macro-averaged F1 score for entities in BILOU format.
languageThe language this model was trained for.

Update Model Name

This API lets you update your model name to your customized need.


curl --location --request PUT '' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header "Authorization: ${AUTHORIZATION_TOKEN}" \
--data-raw "{
\"modelId\": \"${MODEL_ID}\",
\"modelName\": \"New Name\"

Delete Model

To delete your model using the CLI, use this command.

neuralspace nlu delete-model -m $MODEL_ID