Skip to content

Web Viewer

Hawk includes a web UI for browsing and analyzing evaluation results, served via CloudFront.

Opening the Viewer

hawk web                  # open current eval set in browser
hawk web EVAL_SET_ID      # open a specific eval set
hawk view-sample UUID     # open a specific sample

Features

The web viewer supports:

  • Browsing eval sets and scan runs — see all submitted evaluations
  • Filtering samples — by score range and full-text search
  • Comparing results — across eval sets and models
  • Exporting to CSV — download filtered results
  • Shareable URLs — filter state is encoded in query params for easy sharing

Development

To run the viewer locally for development:

cd hawk/www
yarn
yarn dev                  # defaults to staging API server

Using a local API server

VITE_API_BASE_URL=http://localhost:8080 yarn dev

Using a different API server

VITE_API_BASE_URL=https://your-api-server.example.com yarn dev