Use datasets and project files

Open Data inside a project. The left pane separates three kinds of content:

Upload files

1. Open Data.
2. Select Upload Files.
3. Select Choose files and choose one or more files.
4. Select Upload.
5. Wait for each file to show that it finished. A batch can contain both successful and failed files.

The file picker accepts any file type. Each file must be no more than 1 GB. Uploading a file does not by itself queue research or attach the file to a run.

To use an uploaded file, name the file and the work you want during project planning or in chat. Use Add work when the request should enter autonomous research. See Plan and start research and Chat with Marvin and guide research.

Preview a dataset

Open Data, expand Uploads or Outputs, then select a file.

• Tabular formats such as CSV and TSV can show columns and sample rows.
• Other recognized formats show available format and file metadata.
• An unknown or unsupported format can still be stored even when Marvin cannot preview it.
• A preview error does not mean the file was deleted. Use Download to check the stored file.

Read and edit project files

Select a file under Experiment Outputs, Research Documents, or Local outputs.

• Copy copies the visible text.
• Full view opens the available full text when the file is small enough to display.
• Edit replaces the contents of a supported text file when you have write access.
• Download is available for files under Local outputs.
• Open artifact opens the file in the artifact viewer, where you can select exact text to discuss in chat.

Text previews show up to the first 100 lines. Full text is limited to 1 MB, and browser edits are limited to 2 MB. Selecting an image opens it in the artifact viewer. Other binary files show metadata instead of editable text.

Open a figure or file as an artifact

The artifact viewer shows one project file and the version you are viewing. Open it from:

• Data: under Experiment Outputs, Research Documents, or Local outputs, select an image, or select another file and then Open artifact.
• Reports: select a figure.
• Experiments: select a plot in an experiment.
• Chat: select the file name on an attachment in a sent message.

Images open fitted to the width of the reading area. Use + and − to zoom; the readout shows the size relative to Fit. Back returns to where you opened the artifact, at the same reading position. Your chat draft is kept. On a narrow screen, an attachment opened from chat covers the conversation; Back returns to the same place.

The line above the content states the version, such as Retained Git revision or Current file. A figure opened from a report is the current project file; the report does not establish which version it showed when it was written.

See what is recorded about a result

Select About this result. It opens in the chat column; closing it puts the column back as it was.

It lists records that mention the file: Methods records, experiment and iteration passages, related findings with their recorded relationships, and current scripts that name the file. It also lists records from the file's experiment and iteration, marked as not specific to the figure. These are recorded accounts and current source matches, not proof of how an older figure was made: a script that writes the filename today may differ from the one that ran. When records are sparse, the panel says what is missing.

Point Marvin at part of a result

1. Open the artifact.
2. Mark what you mean:
   • Image: drag across the image to mark a region, or click once to mark a point. On a touch screen, tap to mark a point; dragging with a finger (and, on some devices, a stylus) scrolls or zooms, so enter coordinates to mark a region. To use the keyboard, open Mark a point or region and enter x, y, width, and height in original image pixels. A width and height of 0 marks a point. Animated images, SVG files, rotated photos and images over 20 megapixels can be attached only as whole files.
   • Text or code: select the exact text with the mouse or with Shift and the arrow keys. Use Ctrl+F or Cmd+F to find text. A selection can be up to 16,000 characters.
3. Optionally add a note saying what should change.
4. Select Add selection to chat, or Add file to chat when nothing is selected.

The attachment appears as one line above the chat composer: the file name, a short form of the quotation or mark, and whether the version you viewed is kept in Git. Hover over it to see the full quotation and note, or select it to reopen the selection in the viewer. Nothing is sent until you select Send. Several marks or excerpts from one file can be attached and removed separately. The composer holds up to five context items, and adding the same selection and note again does not attach it twice.

When you send, the attachments move into your message. With each one, Marvin receives the content you chose: either the exact quotation and its location, or a copy of the image no larger than 2000 pixels on a side plus a close-up of the marked region and the mark's coordinates. Nothing is drawn on the image. The attachment also supplies bounded current source-candidate paths. Marvin inspects those scripts and the records in About this result with its own project tools. If the model route your project uses cannot see images, the chat says so under the attachments, and Marvin gets the file name, the mark's coordinates and your note, but not the picture. Images larger than 20 megapixels are attached by identity only, without a copy. A file larger than 5 MB opens without exact context: the viewer offers a download of the current file and, for an image, an unmarked preview, but you cannot mark or attach it. The viewer and downloads keep the original file.

Chat can explain a result and help you prepare a precise change request. It cannot edit scripts or regenerate figures. Add work cannot carry attachments; Marvin keeps your draft and attachments and says so.

If the original is unavailable

An attachment refers to the exact version you viewed. If the file later changes or is deleted and that version is not kept in Git, the viewer shows Original unavailable or File changed · original unavailable. Your quotation, mark, and note remain, and Marvin is told that the original cannot be shown. Open current file separately shows today's file without changing the attachment.

Prepare a study for Litmus

When Litmus is available and connected, selecting a research document named docs/study_design_*.md shows the Litmus handoff controls. Use them to request preparation or build a package for review. Nothing is submitted to Litmus until the project owner selects Approve and submit.

See Prepare and submit a study with Litmus.

Download an uploaded dataset or generated output

1. Select the item under Uploads or Outputs.
2. Select Download.

If Marvin says the download is unavailable, the file list may include a file that is no longer reachable. Retry once, then use Troubleshooting and support.

Delete an uploaded dataset or generated output

1. Select the item under Uploads or Outputs.
2. Select Delete.
3. Confirm the deletion.

This permanently deletes the file and removes it from the file list. It cannot be undone and it is not placed in project Trash. Download anything you need before deleting it.

Moving an entire project to Trash follows a separate 30-day recovery path. See Manage and share projects.