> ## Documentation Index
> Fetch the complete documentation index at: https://evalprotocol.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Starting the UI

Reviewing model outputs by hand is an important part of evaluating quality. EP
makes this process simple by offering an easy-to-use, locally hosted UI you can
set up in minutes.

To start the UI, simply run the following command and open your browser to [http://localhost:8000](http://localhost:8000).

```bash CLI theme={null}
ep logs
```

<Note>
  Ensure the `eval-protocol` package is installed so the `ep` CLI is available.

  <Tabs>
    <Tab title="uv">
      ```bash theme={null}
      # Add to your project (installs the `ep` CLI in your environment)
      uv add eval-protocol

      # Verify installation
      uv run ep --version
      ```
    </Tab>

    <Tab title="pip">
      ```bash theme={null}
      # Install or upgrade
      pip install -U eval-protocol

      # Verify installation
      ep --version
      ```
    </Tab>
  </Tabs>
</Note>

Once you navigate to the UI at [http://localhost:8000](http://localhost:8000), you will see a table of
evaluation rows that you can click to inspect.

<Frame caption="First look at the UI">
  <img src="https://mintcdn.com/fireworksai-staging/Gc9EARAuN6GG9vks/assets/table.png?fit=max&auto=format&n=Gc9EARAuN6GG9vks&q=85&s=c2ed5535326048be73ef42827620e901" alt="Table View" width="2996" height="1708" data-path="assets/table.png" />
</Frame>

Whenever you run an `@evaluation_test`—whether from the VSCode Test
Explorer/Debugger or from the CLI via `pytest`—the UI automatically shows
`running` tests and you can watch rollouts live in the chat interface. When a
test finishes, detailed evaluation results appear to the right of the chat.
Tests are stored under a SQLite database on your local device at
`.eval_protocol/logs.db` in the root of your Python project.

To run your tests in CLI, you use the `pytest` command directly.

<Tabs>
  <Tab title="Run with uv virtual environment">
    ```bash theme={null}
    # Run your tests (UI will reflect live rollouts)
    uv run pytest
    ```
  </Tab>

  <Tab title="Run with your current Python environment">
    ```bash theme={null}
    # Run your tests (UI will reflect live rollouts)
    pytest
    ```
  </Tab>
</Tabs>

You can also run tests in your IDE. Once you have your tests running, you can
open the UI at [http://localhost:8000](http://localhost:8000) to monitor
rollouts live.

<Frame caption={<span>Example of a test running in VSCode and the UI showing live rollouts<br/><br/><b>Left:</b> VSCode Test using <code>@evaluation_test</code><br/><b>Right:</b> Log Viewer UI at <a href="http://localhost:8000">http://localhost:8000</a></span>}>
  <video autoPlay muted loop controls playsInline className="w-full aspect-video rounded-xl" src="https://storage.googleapis.com/fireworks-public/eval-protocol/videos/log-viewer-2.webm" />
</Frame>

## Next Steps

Checkout the [Table View](/tutorial/ui/table) and [Pivot View](/tutorial/ui/pivot) for
more information on how to use the UI.