Skip to main content

A simple async Python wrapper for API.

Project description


A simple async Python wrapper for API.

Join the official Discord server here.


  • aiohttp (>=3.6.2)


Make sure to have pip installed in your environement. It will also install all requirements.

pip install -U nekosbest


import asyncio
from typing import Union

from nekosbest import Client, Result

client = Client()

async def get_img(type: str, amount: int = 1) -> Union[Result, list[Result]]:
    result = await client.get_image(type, amount)

loop = asyncio.get_event_loop()

# <Result url= artist_href= artist_name=奥馬 source_url=>
loop.run_until_complete(get_img("nekos", 2))
# [<Result url= artist_href= artist_name=こみやひとま source_url=>, <Result url= artist_href= artist_name=ひゅらさん source_url=>]

Breaking changes

Migrate from 0.x.x to 1.0.0

Client.teardown has been removed, it is no longer needed to pass it when closing.

Migrate from 1.0.20 to 1.1.0

nekosbest.Result.source_details has been removed. Source details are now in Result.
And therefore, nekosbest.Results and nekosbest.SourceDetails got removed too.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nekosbest-1.1.10.tar.gz (16.3 kB view hashes)

Uploaded source

Built Distribution

nekosbest-1.1.10-py3-none-any.whl (19.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page