Skip to main content
Everything in Braven — the desktop watcher, OneDrive sync, and the Python SDK — authenticates with the same credential: a Watcher Key. Get one once, then pick the path that matches how your data is already produced.
1

Generate a Watcher Key

Open app.bravenlab.com and go to Settings (bottom of the left sidebar). Under Watcher Keys, click Generate Key and copy the braven_… value — you’ll need it for whichever path you pick below.
The key is only shown once at creation. If you lose it, revoke it and generate a new one.
2

Choose how data gets in

From the same Settings page, click Download for Windows under Braven Watcher. Run the .exe, paste your Watcher Key when prompted, then Add a folder to watch.Every direct subfolder of a watched folder becomes one Experiment. See Ingest data for the full walkthrough, including OneDrive sync.
3

Confirm a Company and Project exist

Data always lands in a Project inside a Company. If you’re joining an existing team, ask an admin to invite you (Settings → Invite User) — you’ll land in their company automatically. If you’re starting fresh, create a Project from the app’s project switcher.
4

Produce your first Experiment

Drop a data file into the watched folder (or a subfolder — each subfolder becomes its own Experiment). Within a few seconds it appears under Experiments in the app.
5

Attach a pipeline (optional but recommended)

Without a pipeline, an experiment is just a browsable data drop. Add one so every new experiment gets processed into Config, Summary, Series, and Figures automatically — see Write a pipeline script.

​
Next

Learn the terms

Company, Project, Experiment, Run, Device, Pipeline — the vocabulary used everywhere else in these docs.

Tour the app

What each tab — Overview, Experiments, Devices, Analysis, Reports, Pipelines — is actually for.