VKFlow

Современный async-фреймворк для ботов ВКонтакте

pip install vkflow

Type-safe команды

Аргументы автоматически парсятся из аннотаций типов. Валидаторы, конвертеры, кастомные каттеры.

Интерактивный UI

Клавиатуры, карусели, View с callback-кнопками. Полная типизация.

FSM-диалоги

Многошаговые сценарии с хранилищем состояний. Memory, Redis или свой backend.

Cog-модули

Группировка команд в классы с lifecycle-хуками, горячая перезагрузка.

Проверки и cooldown

Декораторы доступа, rate-limiting, max_concurrency из коробки.

Webhook и LongPoll

Оба режима работы, мульти-бот, система аддонов.

Минимальный бот за 10 строк

import vkflow as vf


app = vf.App()

@app.command("ping")
async def ping():
    return "Pong!"

app.run("TOKEN")

FAQ

Как получить токен сообщества?

1. Откройте настройки сообщества

2. Перейдите в Работа с APIСоздать ключ

3. Выберите нужные права доступа (как минимум: сообщения сообщества)

4. В настройках Long Poll API включите Long Poll, выберите версию 5.199+

5. Включите нужные типы событий (как минимум: входящие сообщения)

Если токен начинается с $, VKFlow автоматически подставит значение из переменной окружения: app.run("$VK_TOKEN")

Главная