Upload, browse and manage your notebooks and scripts in My Files from the Files page, JupyterLab and the Wherobots CLI.
File Explorer lets you upload, browse and manage your notebooks and scripts in the Wherobots Cloud console. You can reach your files from the Files page, from JupyterLab, and from the Wherobots CLI.
Each user gets their own My Files location in every region they work in.
The Files page with My Files in AWS US West (Oregon)
Each region has its own My Files. Choose the region before you work with files.
Files page
CLI
Go to the Files page, expand the region, for example AWS US West (Oregon), then expand My Files under it.
Pass --region after my-files:
wherobots files my-files --region aws-us-west-2 ls
Without --region, the CLI uses your Organization’s default region. If your Organization has none, the command fails with your organization has no default region: pass --region <region>.
In the tree, expand My Files in your region, then expand the folder you want to see.
wherobots files my-files lswherobots files my-files ls projects/2026 --output json
The default output is a table with the columns TYPE, SIZE, MODIFIED and NAME. An empty folder prints No files or folders., and so does a folder that does not exist, so check the spelling if you expect files. Use --output json in scripts.
Select the Actions menu next to My Files or the destination folder.
Select Upload Files and choose one or more files.
Click Upload.
If a file with the same name is already in the folder, the dialog warns that it “already exists here and will be replaced by the upload”. Select Replace the existing file to continue.
Give the local file, then the path in My Files. When the path ends in /, the file keeps its local name:
The command prints Uploaded ./report.csv to .... If a file with the same name is already there, the CLI replaces it without asking.The CLI uploads one file per command. To upload many, create the folder first, then loop over the files with modest parallelism. The API can answer HTTP 429 Rate exceeded, and the CLI does not retry for you, so retry failed files.
Select the file in the tree, then click the Download icon in the details panel, or select Download from the file’s Actions menu.
The file menu
Without a local path, the file is saved under its own name in the current folder. When the local path is an existing folder, the file is saved inside it:
Select the file in the tree. The details panel shows a read-only preview for notebooks (.ipynb) and Python (.py) files up to 25 MiB. Larger files show Too large to preview, and other files show No preview.
If a file with the new name is already in the folder, mv replaces it without asking.The Files page and the CLI cannot move a file to another folder. Move it in a notebook, or download it, upload it to the new folder, then delete the original.
rm and rmdir print Deleted ... even when the path does not exist, so check the spelling of the path.
Deleting cannot be undone. If a running notebook saved files in a folder during the last minute, files in a deleted folder can come back. Delete folders from the notebook, or wait about a minute after the last save.
On the Files page, you can open a text file such as .ipynb, .py, .sql, .md, .csv, .txt or .json straight into a new notebook.
Select the file in the tree.
Click the Open File icon in the details panel, or select Open File from the file’s Actions menu. The Open in a Notebook dialog names the region and the path where the notebook will find the file.
Choose the runtime and other options if you need to, then click Open. A new notebook starts in the file’s region, in a new browser tab, and JupyterLab opens the file when it is ready.
Open in a Notebook
If your browser blocks the new tab, click Open workspace in the message on the Files page.
In JupyterLab, My Files is the MY FILES panel. In a notebook terminal, it is /home/wherobots/workspace/my-files. Files in MY FILES are kept across session restarts. Any other folder in the notebook’s file system is deleted when the session restarts.If your notebook still opens in your home folder, your home folder is kept too. See If you used notebooks before My Files.Example notebooks in the EXAMPLES panel are read-only. To change one, right-click it and choose Copy to My Files. See Find your files.
Saving in a notebook is complete when Jupyter shows it as saved.
Change
Where it appears
When
Save, create or rename in a notebook
Your notebooks in the same region
Immediately. When Jupyter shows a file as saved, it is stored and kept, even if your session restarts.
Upload or delete on the Files page, or upload, rename or delete with the CLI
Files page and CLI
The CLI shows the change immediately. On the Files page, your own changes show within a few seconds; changes made elsewhere appear when an open folder next refreshes itself, or when you click the Refresh icon. A collapsed folder shows them when you open it.
Save, create or rename in a notebook
Files page and CLI
About a minute after the file’s last change
Delete in a notebook
Files page and CLI
About a minute after the delete
Upload in the Files page or the CLI
Notebook
Within a few seconds.
Delete in the Files page or the CLI
Notebook
Within a few seconds. When you delete many files at once, some can take up to about a minute. A deleted folder’s files disappear, but the empty folder stays in a running notebook.
The CLI takes paths relative to the root of My Files.
A leading / is ignored: /projects/report.csv and projects/report.csv are the same file.
A trailing / names a folder.
Empty levels (projects//report.csv), . and .. are refused before any request is sent.
To see the requests a command would send without sending them, add --dry-run. The CLI prints each request as a curl command. Without --region, one request is still sent to look up your Organization’s default region.
In a script, check the file’s lastModified time instead of waiting a fixed time. If the file already exists, the CLI lists the previous version until the change arrives, so wait for the time to change. A listed name alone does not mean the new version has arrived. This example uses jq:
set -o pipefail# Prints the file's lastModified time. Fails if the listing fails or the file is not listed yet.modified() { wherobots files my-files ls projects --output json \ | jq -er '.[] | select(.name == "analysis.ipynb") | .lastModified'}# Run this before you save in the notebookbefore=$(modified) || before=""# After you save, wait until the stored copy has the new version.# A failed listing, for example HTTP 429, is retried instead of ending the wait.until now=$(modified) && [ "$now" != "$before" ]; do sleep 10done
If you used Wherobots notebooks before My Files, your notebook opens in your home folder. Your home folder keeps working as before, and My Files is already there, at workspace/my-files. Copy the files you want into My Files:
File browser: right-click a file or folder and select Copy. Open workspace/my-files, right-click an empty area, and select Paste.
Terminal: copy the folder’s contents with cp -r. This works whether or not the folder already exists in My Files:
500 MiB per file on the Files page and in the CLI.
Private to you. Other members of your Organization cannot see your My Files.
Each region is separate. A notebook can reach only the My Files of its own region. To work on a file from another region, use Open File on the Files page.
Cause: The path does not exist in My Files in this region, or a file saved in a notebook in the last minute is not shown yet.Solution: Check the path with wherobots files my-files ls <folder>, and pass --region if the file is in another region. For a notebook save, wait about a minute after the last change.
Files is not enabled for my-files in region <region>
Cause: My Files is not available to you in that region.Solution: Try another --region.
file is <N> MB, exceeding 500 MB limit
Cause: The file is larger than 500 MiB. The CLI message writes the limit as MB.Solution: Split the file, or store it in Managed Storage or an S3 storage integration.
HTTP 429 Rate exceeded
Cause: You sent too many requests in a short time, for example during a bulk upload.Solution: Wait, retry the failed files, and lower the number of parallel uploads. See Upload files.
A file I saved in a notebook is not on the Files page
Cause: The file is saved. The Files page shows it about a minute after the file’s last change.Solution: Wait about a minute after your last save. Open folders update on their own. If the folder is collapsed, expand it.
A folder I deleted came back
Cause: A running notebook saved files in the folder during the last minute, for example in .ipynb_checkpoints. The delete missed those files, and they were copied back.Solution: Delete folders from the notebook, or wait about a minute after the last save, then delete the folder again.
For sign-in errors, see Troubleshooting on the Wherobots CLI page.
