GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing vrchat.community — VRChat.py

VRChat.py

A full-featured Python SDK for the VRChat API, with generated endpoint clients, model types, and authentication helpers.

pypi.org/project/vrchatapi

vrchatapi/vrchatapi-python

Edit this page

Last updated on

Install

pip install vrchatapi

Usage

You can import the VRChat Python SDK, build a Configuration, create an ApiClient, and then use endpoint-specific API classes.

import vrchatapi
from vrchatapi.api import authentication_api

configuration = vrchatapi.Configuration(
    username="your_username_or_email",
    password="your_password",
)

# Build an ApiClient from the configuration (credentials + HTTP session state).
with vrchatapi.ApiClient(configuration) as api_client:
    # VRChat requires app name + version + contact info in User-Agent.
    api_client.user_agent = "ExampleProgram/0.0.1 [email protected]"

    # Create the AuthenticationApi endpoint client using this shared ApiClient.
    # You can do this for other endpoint clients similarly.
    auth_api = authentication_api.AuthenticationApi(api_client)

Authentication

To use authenticated endpoints, you must log in explicitly or use cookies.

You need:

credentials in Configuration (username + password), or
a valid existing session (cookies), such as one restored from disk (see Reusing sessions)

Then call get_current_user() to perform login.

If the account requires 2FA, handle the UnauthorizedException and verify before retrying.

Logging in (with 2FA)

import vrchatapi
from vrchatapi.api import authentication_api
from vrchatapi.exceptions import UnauthorizedException
from vrchatapi.models.two_factor_auth_code import TwoFactorAuthCode
from vrchatapi.models.two_factor_email_code import TwoFactorEmailCode

configuration = vrchatapi.Configuration(
    username="your_username_or_email",
    password="your_password",
)

with vrchatapi.ApiClient(configuration) as api_client:
    api_client.user_agent = "ExampleProgram/0.0.1 [email protected]"
    auth_api = authentication_api.AuthenticationApi(api_client)

    try:
        # Calling get_current_user logs you in if you are not already authenticated.
        current_user = auth_api.get_current_user()
    except UnauthorizedException as e:
        if e.status == 200:
            if "Email 2 Factor Authentication" in e.reason:
                auth_api.verify2_fa_email_code(
                    two_factor_email_code=TwoFactorEmailCode(input("Email 2FA Code: "))
                )
            elif "2 Factor Authentication" in e.reason:
                auth_api.verify2_fa(
                    two_factor_auth_code=TwoFactorAuthCode(input("2FA Code: "))
                )
            current_user = auth_api.get_current_user()
        else:
            raise
    except vrchatapi.ApiException as e:
        print("Exception when calling API:", e)

    print("Logged in as:", current_user.display_name)

The Python SDK uses cookies behind the scenes in its API client. If you keep the same running process and API client alive, authenticated calls can reuse the existing session.
If your app restarts, you usually need to authenticate again unless you implement your own persistent cookie/session storage around the client.

In order to accomplish this, we persist cookies to disk with pickle and reload them on startup.

Note: do not pickle the live CookieJar object directly (it contains a lock and will fail). Instead, pickle the list of cookies and rebuild a jar on load.

import os
import pickle
from http.cookiejar import CookieJar

import vrchatapi
from vrchatapi.api import authentication_api

COOKIE_FILE = "vrchat_cookies.pkl"

configuration = vrchatapi.Configuration(
    username="your_username_or_email",
    password="your_password",
)

with vrchatapi.ApiClient(configuration) as api_client:
    api_client.user_agent = "ExampleProgram/0.0.1 [email protected]"

    # If a saved cookie file exists, rebuild a CookieJar and load it.
    if os.path.exists(COOKIE_FILE):
        with open(COOKIE_FILE, "rb") as fh:
            cookies = pickle.load(fh)
        jar = CookieJar()
        for cookie in cookies:
            jar.set_cookie(cookie)
        api_client.rest_client.cookie_jar = jar

    auth_api = authentication_api.AuthenticationApi(api_client)
    user = auth_api.get_current_user()
    print(f"Logged in as {user.display_name}")

    # Save the cookies (not the jar object itself) after successful login/use.
    with open(COOKIE_FILE, "wb") as fh:
        pickle.dump(list(api_client.rest_client.cookie_jar), fh)

Frequently Asked Questions

Error: please identify yourself with a properly formatted user-agent...

This happens when the request does not include a VRChat-compliant User-Agent header.
Set it explicitly on the API client before making requests:

import vrchatapi

configuration = vrchatapi.Configuration(
    username="your_username_or_email",
    password="your_password",
)

with vrchatapi.ApiClient(configuration) as api_client:
    api_client.user_agent = "ExampleProgram/0.0.1 [email protected]"
    # Continue with API calls...

How do I auto-generate 2FA codes instead of typing them manually?

Use pyotp to generate authenticator (TOTP) codes from your account's secret key. Obtain this during 2FA setup on the vrchat website by pressing "Copy" on the link displayed when scanning the 2FA QR code. It will look like this: otpauth://totp/VRChat:your_email_here?secret=COPY_THIS_SECRET&issuer=VRChat

Install it:

pip install pyotp

Minimal code generation example:

import pyotp

TOTP_SECRET = "YOUR_BASE32_SECRET_FROM_QR_SETUP"
code = pyotp.TOTP(TOTP_SECRET).now()
print(code)  # Example: 123456

Use it in the VRChat login flow:

import pyotp
import vrchatapi
from vrchatapi.api import authentication_api
from vrchatapi.exceptions import UnauthorizedException
from vrchatapi.models.two_factor_auth_code import TwoFactorAuthCode

TOTP_SECRET = "YOUR_BASE32_SECRET_FROM_QR_SETUP"

configuration = vrchatapi.Configuration(
    username="your_username_or_email",
    password="your_password",
)

with vrchatapi.ApiClient(configuration) as api_client:
    api_client.user_agent = "ExampleProgram/0.0.1 [email protected]"
    auth_api = authentication_api.AuthenticationApi(api_client)

    try:
        current_user = auth_api.get_current_user()
    except UnauthorizedException as e:
        if e.status == 200 and "2 Factor Authentication" in e.reason:
            code = pyotp.TOTP(TOTP_SECRET).now()
            auth_api.verify2_fa(two_factor_auth_code=TwoFactorAuthCode(code))
            current_user = auth_api.get_current_user()
        else:
            raise

    print("Logged in as:", current_user.display_name)

JavaScript

A fully-featured JavaScript SDK for the VRChat API, with first-class TypeScript support, strict typing, and built-in authentication.

Dart

A Dart SDK for interacting with the VRChat API, allowing developers to create applications that can access and manipulate VRChat data.

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.