Get up and running with Watchful by following the steps below.

1. Download and run the Watchful App from AWS ECR

## Login
aws ecr get-login-password --region us-west-1 | \
    docker login \
        --username AWS \
        --password-stdin \

## Run the Container
docker run \
  --name watchful \
  -d -p 9001:9001 \
  -v ~/watchful:/root/watchful \
  -e WATCHFUL_LOG=info \

2. Create new project


3. Import data

You can access the import modal by clicking Dataset in the menu bar.


4. Create classes

Once data has been imported, create the classes you want to start labeling for by, going to the input box, just right of the words "Selected Class", writing out the name of the class, and hitting enter. If you're not sure what your classes are at this point, you can always create them one-by-one as you go.


Class names must be of the following format:

  • Class names must start with an uppercase letter
  • Can only contain alphanumerical characters or '_'
  • Cannot exceed 32 characters.

Watchful has two class options NER Named Entity Recognition or FTC Full Text Classification. Class selection affects some query features and UI modes that are class specific.


5. Choose a class

Select a class to start labeling for by simply typing its name in the "Selected Class" input box.


6. Hand label some data

Click into the "Hand Label" tab in the center of the nav bar, and label a few pages of candidates until the Base Rate chart stabilizes. This will help give Watchful some initial signal to calibrate it to your class.


7. Seed the system with some hinters, until hinter suggestions start becoming helpful

Write your first few hinters by experimenting with simple queries (see Querying) and committing them as Hinters. Check out the querying cheat sheet for help getting started.


8. Click on a hinter suggestion that looks promising.

To learn more about Hinter Suggestion types read more on Hinters


9. Add an expectation for the query and commit the hinter

To learn more about expectation best practices see Hinters


10. Repeat from step 7 until confidence is > 3500 or charts look correct


11. Repeat from step 4 until confidence is >3500 for all classes

12. Collaborate with your team members

Go to the settings page, give your self a username, and connect to your organization's Watchful Hub. More on Setting up Watchful Hub here.


Share your project


Share your progress and incorporate other's by going into the collaboration view. Pull in other team member's actions from Watchful-Hub, and Push your own actions.


What’s Next

Dig deeper and learn how to take full advantage of Watchful