Skip to main content
Pluto allows you to save arbitrary files during your experiments. This is useful for saving model checkpoints, configuration files, output data, or any other files you want to associate with a run.

Logging Files

Use pluto.File() with run.log() to save a file to your experiment:
import json
import pluto

run = pluto.init(project="my-project", name="experiment")

# Write a JSON file
results = {"accuracy": 0.95, "loss": 0.05}
with open("results.json", "w") as f:
    json.dump(results, f)

# Log it to Pluto
run.log({"results": pluto.File("results.json")})

run.finish()

Viewing Files

Files logged during an experiment can be viewed in the web UI. Navigate to your experiment, click the Summary tab, and visit the Files section. Screenshot 2026 01 21 At 2 14 08 PM
Plain text files will only render in dropdown if they are saved with a supported filename extension (i.e. .txt, .yaml, .py, etc.). For files that don’t follow this convention, the file won’t be viewable via the webUI but will still be downloadable.

Use Cases

Common use cases for file logging include:
  • Configuration files: Track the exact configuration used for each run
  • Output data: Save predictions, embeddings, or other generated data
  • Logs and reports: Save text logs or generated reports
For logging specific media types with built-in visualization support, see:
  • Images - Log and visualize image data
  • Audio - Log and play back audio files
  • Video - Log and view video files