Skip to main content

Python MongoDB compatibility quickstart

This quickstart will get you up and running with an application that demonstrates Tigris MongoDB compatibility.

You can view the source for the Python MongoDB compatibility quickstart app on GitHub.


Get the code

Clone the repo, navigate into the directory, and install the application dependencies:

git clone
cd tigris-mongodb-python-example

Preparing Tigris

  1. Create a project in Tigris.
  2. Create an application key, and copy the Project Name, Client ID, and Client Secret values.

Setting up the environment

Activate your Python virtualenv and install dependencies.

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Add an environment variabled named MONGODB_URL with the connection string to Tigris. Be sure to replace {TIGRIS_CLIENT_ID}, {TIGRIS_CLIENT_SECRET}, and {TIGRIS_PROJECT_NAME} with your values.


Run the app

Start the app as follows:

uvicorn app:app --reload

API endpoints

Create a new Game:

curl --location --request POST 'http://localhost:8000/games' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Fable Anniversary",
"price": 4.99,
"category": "Video Game"

List Games:

curl --location --request GET 'http://localhost:8000/games'

Get a single Game:

curl --location --request GET 'http://localhost:8000/games/{_id}'

Delete a Game:

curl --location --request DELETE 'http://localhost:8000/games/{_id}'

Explore the data

You can explore the data created by the quickstart application in the Tigris Cloud Console.