Skip to main content
This guide demonstrates how to use the Python client library to upload, list, download, and delete files in your App Storage bucket.

​
Create a Python Replit App

  1. Select plus sign Create App from the home screen.
  2. Navigate to the Choose a Template tab.
  3. Type “Python” in the template search field and select it as shown below:
    Python template selection screen
  4. Select plus sign Create App.

​
Install the official client library

To install the client library, follow the one-click setup or package manager instructions below.
  • One-click setup
  • upm
  • pip
1

Access the App Storage tool

  1. Navigate to the App Storage tab.
  2. Select the angled brackets icon Commands view in the App Storage tab.
The installation screen should resemble the following screenshot:
screenshot of App Storage package installation
2

Install the dependencies

  1. Select “Python” from the programming language dropdown on the top left.
  2. Select Install replit-object-storage package.
  3. When completed, the button text should read Package installed.

​
Create a bucket

Before storing objects, you must create a bucket. Follow the steps below to create a new bucket:
  1. Navigate to the App Storage tool
  2. Select Create new bucket
  3. Enter a name for the bucket in the Name field
  4. Select Create bucket

​
Add and run the example code

1

Locate main.py

Open the files icon Files tool from the left dock.Select main.py to open it in a file editor.
2

Add the client code

Copy and paste the following code into main.py:
# Instantiate a Client
from replit.object_storage import Client
client = Client()

# Upload a text file that contains the text "Hello, World!"
client.upload_from_text("file.txt", "Hello World!")

# List the objects in the bucket
objects = client.list()
print("Bucket contents:", objects)

# Retrieve and print the contents of the uploaded file
contents = client.download_as_text("file.txt")
print("file.txt contents: ", contents)
3

Run the app

Select Run to execute the example code.Navigate to the Console tab to view the output, which should resemble the output below:
Bucket contents: [Object(name='file.txt')]
file.txt contents:  Hello World!
Confirm that the file.txt object appears in your bucket in the Objects view of the Object Storage tool.
Reload the page to update the object list if file.txt fails to appear.

​
Delete the object

To remove the file.txt file from the bucket,
  1. Replace the content of main.py with the following code: 
    from replit.object_storage import Client
client = Client()

# Delete file.txt from the bucket
client.delete("file.txt")
print("Delete succeeded")
  2. Select Run to execute the example code.
  3. Navigate to the Console tab to view the output, which should resemble the output below: 
    Delete succeeded
  4. Verify that the file.txt object no longer appears in the bucket.

​
Next steps

To learn more about Replit App Storage, see the following resources: