# Real-Time Capture Setup

GoFigr's Real-Time Capture automatically syncs every figure you create — along with its source code, data, and environment — to the GoFigr web app. Once enabled, there's nothing to do manually: figures appear in GoFigr as you create them.

The quickest way to get started is the **setup wizard** in the GoFigr web app. It generates a ready-to-use starter file for your environment in four steps.

## Launching the Wizard

Click **Real-Time Capture** under Quick Actions on the home page:

![Quick Actions section showing the Real-Time Capture button](https://3119956814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK8IQeYtJFb8a0WJJc5WC%2Fuploads%2Fgit-blob-5ad77d543927de37383a39b1e1d0757b3cb435ce%2Frealtime_capture_00_button.png?alt=media)

## Walkthrough

### Step 1: Choose Your Environment

Select the environment that matches your workflow:

* **Jupyter Notebook** — JupyterLab, Jupyter Notebook, VS Code notebooks
* **Python Script** — Standalone `.py` files for scripts and applications
* **R Documents & Scripts** — R Markdown, R scripts, RStudio, Quarto

![Choose your environment - Jupyter Notebook, Python Script, or R Documents & Scripts](https://3119956814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK8IQeYtJFb8a0WJJc5WC%2Fuploads%2Fgit-blob-2d18ebb09ba96ef7ca84dd4220c21411ed75c51f%2Frealtime_capture_01_environment.png?alt=media)

### Step 2: Install & Configure

The wizard shows the install commands for your chosen environment. For Python, this is:

```bash
$ pip install gofigr
$ gfconfig
```

`gfconfig` is a one-time setup that saves your API key and default workspace to `~/.gofigr`. If you've already run it, click "Skip to next step" to continue.

![Install and configure step showing pip install and gfconfig commands](https://3119956814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK8IQeYtJFb8a0WJJc5WC%2Fuploads%2Fgit-blob-ab1063b5f62b1f8030cb7242d1ce01efcb5ad996%2Frealtime_capture_02_install.png?alt=media)

### Step 3: Configure Where Figures Go

Choose how your figures are routed:

* **Use my gfconfig defaults** — Uses the workspace and API key from your `gfconfig` setup (Step 2). The analysis will be named after your file.
* **API Key** — Optionally create a new API key dedicated to this setup, or use an existing one.

![Configure where figures go - use gfconfig defaults or create a new API key](https://3119956814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK8IQeYtJFb8a0WJJc5WC%2Fuploads%2Fgit-blob-99603289fa3d5c3471ed0f18f90632c8c84f03cc%2Frealtime_capture_03_config.png?alt=media)

### Step 4: Download Your Starter File

Your starter file is ready. You can:

* **Download** the file directly
* **Copy to clipboard** and paste into your editor

The generated file includes:

* GoFigr initialization with your chosen settings
* An example plot to verify everything works
* Optional data tracking and Clean Room examples

![Download or copy the generated starter file with a code preview](https://3119956814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK8IQeYtJFb8a0WJJc5WC%2Fuploads%2Fgit-blob-e1d76a8961c88de119f24199b8546eedb20a04a3%2Frealtime_capture_04_download.png?alt=media)

## What the Starter File Does

When you run the generated file, every figure you create is automatically captured and synced to GoFigr — including the source code that produced it. This means:

* **Full provenance**: Each figure is linked to the exact code, data, and environment that created it
* **Automatic organization**: Figures are grouped into analyses named after your file
* **QR codes**: Each figure gets a unique QR code and revision ID for easy tracking
* **No manual publishing**: Figures appear in GoFigr as you create them

## Next Steps

* [Clean Room (Python)](https://docs.gofigr.io/features/clean-room-python) / [Clean Room (R)](https://docs.gofigr.io/features/clean-room-r) — Make your figures fully reproducible and re-runnable in the browser
* [AI Story Mode](https://docs.gofigr.io/features/story-mode) — Turn your captured figures into presentations
* [Auto-Assign](https://docs.gofigr.io/features/auto-assign) — Let AI organize figures into analyses automatically