# 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](/files/nPYIgZEh7ERPW6BijHqK)

## 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](/files/MvB33YJ3grUg0q3v2CiS)

### 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](/files/4csi2TDeexfaWhTEhy8u)

### 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](/files/e0y5w3igH87g9u7kFjsl)

### 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](/files/15BfQ9uKRbHmHHBe0BzB)

## 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)](/features/clean-room-python.md) / [Clean Room (R)](/features/clean-room-r.md) — Make your figures fully reproducible and re-runnable in the browser
* [AI Story Mode](/features/story-mode.md) — Turn your captured figures into presentations
* [Auto-Assign](/features/auto-assign.md) — Let AI organize figures into analyses automatically


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gofigr.io/features/realtime-capture.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.