Skip to content

Sample FastAPI-based web application boilerplate/template repository

Notifications You must be signed in to change notification settings

nb-programmer/python-sample-fastapi

Repository files navigation

Sample FastAPI application

Sample FastAPI application.

Template

Note that this is a template project. You will need to make changes to this application if you want to make use of it. Please read the Template readme file for more information on what this project does and how to use the template.

Development setup

  1. (Optional) Install Pyenv and the Python version for this project:
pyenv install
  1. Create a virtual environment:
# Note: For POSIX, pyenv can create a named virtual environment which you can use instead.
# For Windows, pyenv-win exists, but doesn't have this feature afaik.

python3 -m venv venv

# Windows
./venv/Scripts/activate

# POSIX
source ./venv/bin/activate
  1. [Windows] Run the scripts/dev-setup.bat script:
./scripts/dev-setup.bat
  1. [POSIX] Run the scripts/dev-setup.sh shell script using any bash-compatible shell:
bash ./scripts/dev-setup.sh
  1. Create a .env file from the given example and edit it:
cp .env.example .env

# Open the new .env file in your favourite editor and make the changes
  1. Run the dev server using F5 key in VSCode. You can also use the dev-launch shell script:
# Windows
./scripts/dev-launch.bat

# POSIX
bash ./scripts/dev-launch.sh
  1. You can also run the cli script:
sample-fastapi --help