How-to guide

Run an analysis

Point Bristlenose at a folder and produce a report.

A run transcribes your recordings, identifies the speakers, analyses the result, and produces the report. How you start one depends on whether you use the macOS app or the command line.

macOS app
  1. Drag a folder of recordings onto the sidebar (or onto the New Project card). Bristlenose creates a project named after the folder and starts the analysis straight away.
  2. Watch progress on the project's row in the sidebar — a ring and a status line such as "Transcribing · 7 of 8 · ~1 min left".
  3. To stop a run, hover the row and click the × on the ring, or press ⌘. (Command-period).

When it finishes, the report opens. To create an empty project first, use + New Project at the top of the sidebar (or File → New Project, ⌘N), then drag a folder onto it.

The app always runs the full pipeline. Re-analysing a project, and transcribe-only or analysis-only runs, are not available in the app — use the command line for those.

Command line

Point Bristlenose at a folder:

bristlenose run interviews

bristlenose interviews is shorthand for the same command. Choose the analysis provider with --llm:

bristlenose run interviews --llm gemini

By default the report is written inside the folder, under bristlenose-output/; override with --output. Other useful options:

  • --redact-pii — redact personal data before analysis (see Redact personal information).
  • --clean — delete previous output and start fresh.
  • -w small — a smaller, faster transcription model.

If a run is interrupted, run the same command again to resume from where it stopped. To re-open a finished report later without re-running: bristlenose serve interviews. The full option list is in CLI commands.

The provider used for analysis is whichever you set up — see the per-provider guides under How-to guides. For what the run does at each stage, see The analysis pipeline.