Skip to main content

How to Install the Python SDK

Installing SDK

There are several ways for you to install our SDK and the most convenient one is to use a package manager.

Installing with Package Manager

The easiest way to integrate our SDK into your project is to use pip. Run the following command to install it:

pip install leancloud

Depending on the environment you're using, you may need to add sudo at the beginning of the command.

Installing Manually

Python SDK

Initializing Your Project

Then import leancloud and call init to initialize it:

import leancloud

leancloud.init("your-app-id", "your-app-key")
# Or use Master Key
# leancloud.init("{{appid}}", master_key="{{masterkey}}")

Enabling Debug Logs

You can easily trace the problems in your project by turning debug logs on during the development phase. Once enabled, details of every request made by the SDK along with errors will be output to IDE, browser console, or your app's Dashboard > LeanEngine > App logs.

# Place the code at the beginning of the start-up script
# If used in LeanEngine, the start-up script is
import logging


Make sure debug logs are turned off before your app is published. Failure to do so may lead to the exposure of sensitive data.


First of all, make sure you are able to connect to LeanCloud server. You can test it by running the following command:

curl "https://{{host}}/1.1/date"

If everything goes well, it will return the current date:

{ "__type": "Date", "iso": "2020-10-12T06:46:56.000Z" }

Then add the following code into your project:

TestObject = leancloud.Object.extend('TestObject')
test_object = TestObject()
test_object.set('words', "Hello world!")

Save and run your program.

Then go to Dashboard > Data Storage > Data > TestObject. If you see a row with its words column being Hello world!, it means that you have correctly installed the SDK.

See Debugging if you’re not seeing the content.


This guide is written for the latest version of our SDK. If you encounter any error, please first make sure you have the latest version installed.

401 Unauthorized

If you get a 401 error or see the following content in network logs:

"code": 401,
"error": "Unauthorized."

It means that the App ID or App Key might be incorrect or don't match. If you have multiple apps, you might have used the App ID of one app with the App Key of another one, which will lead to such error.

Client Cannot Access the Internet

Make sure you have granted enough permissions for your mobile app.