vkbottle-types

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 on this page — 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

vkbottle-types on PyPI

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

Evidence: vkbottle_types-5.199.99.21-py3-none-any.whl

Keywords: bottle methods, bottle objects, bottle types, framework types, types, types bottle, vk api, vk methods, vk objects, vkbottle, vkbottle methods, vkbottle objects, vkontakte

Tags

More Python Modules packages