Skip to main content

Anime-themed action and reaction image API wrapper for Python

Project description

animact

Anime-themed action and reaction image API wrapper for Python.

PyPI License


✨ Features

  • Simple API to fetch anime reaction/action images
  • Over 50+ categories: hug, pat, slap, wave, etc.
  • Both synchronous and asynchronous support
  • Minimal dependencies
  • Simple and easy-to-use
  • Multiple import patterns for flexibility

🚀 Installation

pip install animact

📖 Usage

Synchronous Usage

There are three ways to use the synchronous API:

  1. Direct Function Import (Simplest)
from animact import hug, pat
url = hug()
pat_url = pat()
  1. Using Default Instance
from animact import animact
url = animact.hug()
pat_url = animact.pat()
  1. Creating Custom Instance
from animact import Animact
client = Animact()
url = client.hug()
pat_url = client.pat()

Asynchronous Usage

There are two ways to use the asynchronous API:

  1. Using Default Async Instance (Recommended)
import asyncio
from animact import async_animact

async def main():
    url = await async_animact.hug()
    pat_url = await async_animact.pat()

asyncio.run(main())
  1. Creating Custom Async Instance
import asyncio
from animact import AsyncAnimact

async def main():
    client = AsyncAnimact()
    url = await client.hug()
    pat_url = await client.pat()

asyncio.run(main())

Complete Example

import asyncio
from animact import (
    # Sync imports
    hug, pat,  # Direct functions
    animact,   # Default sync instance
    Animact,   # Sync class
    # Async imports
    async_animact,  # Default async instance
    AsyncAnimact    # Async class
)

# Synchronous usage
print("Sync - Direct functions:")
print(hug())
print(pat())

print("\nSync - Default instance:")
print(animact.hug())
print(animact.pat())

# Asynchronous usage
async def main():
    print("\nAsync - Default instance:")
    print(await async_animact.hug())
    print(await async_animact.pat())
    
    print("\nAsync - Custom instance:")
    client = AsyncAnimact()
    print(await client.hug())
    print(await client.pat())

if __name__ == "__main__":
    asyncio.run(main())

📚 Available Actions

All these actions are available in both synchronous and asynchronous versions:

  • lurk
  • shoot
  • sleep
  • shrug
  • stare
  • wave
  • poke
  • smile
  • peck
  • wink
  • blush
  • smug
  • tickle
  • yeet
  • think
  • highfive
  • feed
  • bite
  • bored
  • nom
  • yawn
  • facepalm
  • cuddle
  • kick
  • happy
  • hug
  • baka
  • pat
  • angry
  • run
  • nod
  • nope
  • kiss
  • dance
  • punch
  • handshake
  • slap
  • cry
  • pout
  • handhold
  • thumbsup
  • laugh
  • bully
  • lick
  • bonk
  • glomp
  • kill
  • cringe
  • spank

🌟 Star This Project

If you like this project, please consider starring it on GitHub — it really helps!


🧑‍💻 Contributing

Pull requests are welcome. For major changes, please open an issue first.


📄 License

MIT License — see LICENSE file for details.


☕ Support Me

Buy Me a Coffee

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

animact-1.1.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

animact-1.1.0-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file animact-1.1.0.tar.gz.

File metadata

  • Download URL: animact-1.1.0.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for animact-1.1.0.tar.gz
Algorithm Hash digest
SHA256 36bdf3bdf8983fcfd6436657ac84774fc1b02d63e501edbb9b5def9d166a6bd8
MD5 409c9d645695e4d23a83c2b1730f543e
BLAKE2b-256 5d9c656541b7f9dbe6644fcad08e32a7ef3eaf69a66c9b45a4e61a8f997b2237

See more details on using hashes here.

File details

Details for the file animact-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: animact-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for animact-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 596c3b50e2a6430c81dcfe1798a0457d530fbcf7d6c934e06dd0eb6b0234ca9b
MD5 9a37e988ee58150d6526ac4a8a784e2d
BLAKE2b-256 64a50f5855a29b58497c9b821885f778c47ef8ab5e73d38cf4b18bf486650311

See more details on using hashes here.

Supported by

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