How to download file using Python Flask


Here I am going to show a simple example on how to download a file using Python Flask. We will download the file which is kept in the server location. The file could be any type of file, i.e., pdf, text, excel, word etc. In this example there will be a simple UI (user Interface), where a link will be provided to the user and clicking on the link a file will be download. The downloaded file will ask you to choose a location for saving it.

There could be any reason to download a file from server. The reason could be, you want to generate reports from database and download these reports.


Python 3.8.0, Flask 1.1.1

Now we will create the web application that will download a any kind of file which is kept on a server location.

Creating Project Directory

First step is to create a project root directory under which we will put all our required files for the project.

Let’s say I am going to create a project root directory python-flask-file-download.

We may not mention the project root directory in subsequent sections while creating new files and we will assume that we are talking with respect to the project’s root directory.

Configuring Flask

Create the below script(py is the extension to indicate Python script) where we import the flask module. This file should be created under the project root directory. Notice how we create flask instance.

from flask import Flask

app = Flask(__name__)

Configuring URLs

Next we will create script that will define all URIs or Action paths for performing certain operations such as rendering the UI and downloading the file from server.

from app import app
from flask import Flask, send_file, render_template
def upload_form():
	return render_template('download.html')

def download_file():
	#path = "html2pdf.pdf"
	#path = "info.xlsx"
	path = "simple.docx"
	#path = "sample.txt"
	return send_file(path, as_attachment=True)

if __name__ == "__main__":

In the above source code, the root path or endpoint will simply render the UI. This UI contains only one link for downloading a file from the server. Clicking on the link will ask user to save the file in a chosen location.

the endpoint /download is called on clinking upon the link on UI and a file is sent to the client or UI. The file type could be anything. As you see I have tested with four types of files. I hope this example will work with other file types as well.

UI Template

Now create download.html file and put it under templates directory. templates directory is the standard directory structure of Flask based web application for putting templates or HTMLs or any static resources – js, css, images.

<!doctype html>
<title>Python Flask File Download Example</title>
<h2>Download a file</h2>

	<a href="{{ url_for('.download_file') }}">Download</a>

Notice in the above template file we are using Flask EL (Expression language) to evaluate the link endpoint.

Testing the Application

Now navigate to the project root directory from command line tool and execute the command python, your server will start on default port 5000.

If you want to change the port then you can change the line to, where 5001 is the new port.

Home Page

Hitting the URL http://localhost:5000 will show you a page similar to the below image:

download file using python flask

Clicking on the download link will ask you to save the file according to your chosen location.

Source Code


Thanks for reading.

One Thought to “How to download file using Python Flask”

  1. Ahmed

    Thanks thats helped me alot!

Leave a Comment