---
id: vkbottle-types
version: "5.199.99.21"
license: MIT
license_treatment: permissive
maintenance: active
---

# vkbottle-types — VK API methods & types for vkbottle.

License: permissive · Maintenance: active · Downloads: 356.8K/mo

## What it is and what it does

vkbottle-types is a type-definition library that mirrors the VK API schema for use with the vkbottle bot framework. It provides Pydantic-based type hints and method signatures for VKontakte API calls, enabling static type checking and IDE autocompletion when building VK bots and applications. The package is generated from the official VK API schema and includes a patching mechanism to work around inconsistencies in the upstream schema.

The library depends on msgspec for serialization, pydantic for validation, and typing-extensions for compatibility across Python versions 3.10–3.14. It is maintained actively and designed to be kept in sync with VK API updates, though bug reports and patches are directed to the main vkbottle repository.

Use it for:

- Building a VK bot with full type safety and IDE autocompletion for API method calls and response objects.
- Validating VK API responses against the official schema using Pydantic models before processing.
- Generating type stubs for VK API interactions in a larger application that uses vkbottle.
- Ensuring compatibility with current VK API versions by using up-to-date method and object definitions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type definitions and API method signatures for the VK API, designed for use with the vkbottle framework to enable type-checked interactions with VKontakte services.

Yes, if you are building with vkbottle. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides essential type safety for VK API development. Install friction is low and dependencies are standard. Only skip it if you are not using vkbottle or do not need type hints for VK API calls.

## Install

pip install vkbottle-types
uv add vkbottle-types
poetry add vkbottle-types

## Installing vkbottle-types

Before you install: Low install friction with a pure-Python wheel distribution. Maintained actively with a recent release within the past 73 days. Depends on msgspec, pydantic, typing-extensions, and vkbottle—all standard, well-maintained libraries.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license notice.

Quickstart:

pip install vkbottle-types

from vkbottle_types import methods, objects
# Use type definitions in vkbottle bot code
bot = vkbottle.Bot(token="...")
# Type hints now available for VK API calls

Requires Python 3.10 or later (supports up to 3.14); vkbottle must be installed separately as a runtime dependency.

Verify before relying:

- Whether the package tracks the official VK API schema automatically or requires manual updates when VK releases breaking changes.
- Coverage of all current VK API methods and objects, or which parts of the API may have incomplete type definitions.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 356.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vk api types, vkbottle types, vkontakte api types, vk api method signatures, vkbottle framework types, vk api schema types, vkontakte bot types, vk-api, type-definitions, bot-framework

[View on SkillFed](https://skillfed.io/packages/vkbottle-types) · [View on PyPI](https://pypi.org/project/vkbottle-types/)