🪨 Rosetta Setup Facility

Sign in with your GitHub account to set up a new facility for the Rosetta CT metadata pipeline. This wizard will walk you through every step.

Waiting for authorization…
1Access
2Request
3Approval
4Install
5Verify

Step 1 — Confirm Collaborator Access

You need collaborator (write) access to the Rosetta repository before you can create a facility.

Step 2 — Request Facility

Join an existing facility or create a new one. Each facility can have multiple X-ray machines.

Existing Facilities
Loading…
Create New Facility
A short, unique name (used in directory names and config).
Add each machine that will push data to this facility.

Step 3 — Awaiting Approval

Your facility request has been submitted. A maintainer will review it and add the facility-approved label. This page checks automatically.

Checking issue for approval…

Step 4 — Install the Rosetta Edge Watchdog

Your facility is ready. Install the watchdog on the machine where your scanner writes data.

Prerequisite — Python on PATH
Open a terminal and run python --version. If it's not recognized, install Python from python.org and check "Add Python to PATH" during setup.
PyCharm/Anaconda bundle their own Python but don't add it to the system PATH. You can also run these commands inside PyCharm's Terminal tab instead.
1. Clone and install
git clone https://github.com/johntrue15/Rosetta.git cd Rosetta/edge python -m pip install -e .
2. Download your config

Your config.yml was auto-generated when the facility was approved. Download it and place it in the edge/ directory.

3. Run the watchdog with your GitHub token

Create a Personal Access Token with repo scope, then run:

rosetta-watchdog -c config.yml --token ghp_YourTokenHere

A bundled example.pca test file is included in edge/test_data/. Copy it into your watch folder to confirm the full upload loop works.

Alternative: set token via environment variable

If you prefer not to pass the token on the command line, set it as an environment variable in the same terminal before running the watchdog:

Mac / Linux
Windows PowerShell
Windows CMD
export ROSETTA_GITHUB_TOKEN="ghp_YourTokenHere" rosetta-watchdog -c config.yml
$env:ROSETTA_GITHUB_TOKEN = "ghp_YourTokenHere" rosetta-watchdog -c config.yml
set ROSETTA_GITHUB_TOKEN=ghp_YourTokenHere rosetta-watchdog -c config.yml

Step 5 — Verify Data Upload

Let's check if the watchdog is successfully pushing data to your facility directory on main.