Skip to content

vndb-client

A fully typed, HTTP-based Python client for the VNDB (Visual Novel Database) Kana API.

Install

pip install vndb-client

Quickstart

from vndb_client import Client

with Client() as client:
    page = client.vn.query(filters=["search", "=", "ever17"], results=5)
    for vn in page.results:
        print(vn.id, vn.title)

Highlights

  • Sync and async — Client and AsyncClient share one core.
  • Typed models — Pydantic models for VNs, releases, producers, characters, staff, tags, traits, quotes.
  • Filter DSL — (vn_filters.rating >= 80) & (vn_filters.lang == "en").
  • User lists — read a list, then write votes, notes, labels, and rlist state.

Where to next