semvec/pypi-packages huggingface dataset:
nekos.life-async 1.0.5
An unofficial asynchronous wrapper for nekos.life API
License: MIT
Requires Python: >=3.8.0

# nekos.life-async

[![PyPI version info](https://img.shields.io/pypi/v/nekos.life-async)](https://pypi.python.org/pypi/nekos.life-async)
[![PyPI supported Python versions](https://img.shields.io/pypi/pyversions/nekos.life-async)](https://pypi.python.org/pypi/nekos.life-async)
[![PyPI downloads](https://img.shields.io/pypi/dd/nekos.life-async)](https://pypi.python.org/pypi/nekos.life-async)
[![PyPI License](https://img.shields.io/pypi/l/nekos.life-async)](https://pypi.python.org/pypi/nekos.life-async)

> An unofficial asynchronous wrapper for nekos.life API

# Features

- You can download the images! (using [aiofile](https://pypi.org/project/aiofile/))
- Support with SFW and NSFW images!
- Easy to use with an object-oriented design.

# Install

```sh
# Linux/macOS
python3 -m pip install -U nekos.life-async

# Windows
py -3 -m pip install -U nekos.life-async
```

## Optional Packages

- [aiodns](https://pypi.org/project/aiodns), [brotlipy](https://pypi.org/project/brotlipy), [cchardet](https://pypi.org/project/cchardet/) (for aiohttp speedup)
- [orjson](https://pypi.org/project/orjson) (for json speedup)

# Quick Example

```py
from nekos import NekosLifeClient, SFWImageTags
from asyncio import get_event_loop

client = NekosLifeClient()


async def main():
    result = await client.image(SFWImageTags.WALLPAPER)
    print(result.url)


loop = get_event_loop()
loop.run_until_complete(main())
```

# Links

- [Original Package](https://github.com/Nekos-life/Async-nekos.life-wrapper)
- [Issues](https://github.com/ysIgnacio/nekos.life-async/issues)