Installation¶

vk-mini-app-auth supports Python 3.10 and newer. The runtime package has no external dependencies.

Install the package¶

python -m pip install --upgrade vk-mini-app-auth

poetry add vk-mini-app-auth

uv add vk-mini-app-auth

Prepare a project environment¶

For a new project, create and activate a virtual environment first:

mkdir vk-mini-app-backend
cd vk-mini-app-backend
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

On Windows PowerShell, activate the environment with:

.venv\Scripts\Activate.ps1

Configure VK credentials¶

Your backend needs two values from VK app settings:

• VK_APP_ID: the numeric application ID.
• VK_SECRET_TOKEN: the secure key used to validate launch parameter signatures.

Store them outside source control:

export VK_APP_ID=53377165
export VK_SECRET_TOKEN="secure-key-from-vk-settings"

Verify the installation¶

python - <<'PY'
from vk_miniapp_auth import VKMiniAppAuthenticator

authenticator = VKMiniAppAuthenticator(53377165, "secure-key")
print(type(authenticator).__name__)
PY

You should see:

VKMiniAppAuthenticator

Continue with the quickstart.