https://github.com/xeyossr/waifupicsgo
🌸 Go client for waifu.pics
https://github.com/xeyossr/waifupicsgo
anime anime-api api-client go go-library golang http-client image-api nsfw random-images rest-api sdk sfw waifu wrapper
Last synced: 2 months ago
JSON representation
🌸 Go client for waifu.pics
- Host: GitHub
- URL: https://github.com/xeyossr/waifupicsgo
- Owner: xeyossr
- License: gpl-3.0
- Created: 2025-07-27T11:34:42.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-07-27T11:54:37.000Z (2 months ago)
- Last Synced: 2025-07-27T13:30:01.720Z (2 months ago)
- Topics: anime, anime-api, api-client, go, go-library, golang, http-client, image-api, nsfw, random-images, rest-api, sdk, sfw, waifu, wrapper
- Language: Go
- Homepage:
- Size: 18.6 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# waifupicsgo 🖼️
A simple **Go client** for [waifu.pics](https://waifu.pics) — fetch random **SFW/NSFW anime images** effortlessly!
## Install
```bash
go get github.com/xeyossr/waifupicsgo@latest
```
## Usage
```go
import "github.com/xeyossr/waifupicsgo"
// SFW examples
img, _ := waifupicsgo.SFW.GetOne(waifupicsgo.SFWHug.String())
imgs, _ := waifupicsgo.SFW.GetMany(waifupicsgo.SFWHug.String())
// NSFW examples
img, _ := waifupicsgo.NSFW.GetOne(waifupicsgo.NSFWNeko.String())
imgs, _ := waifupicsgo.NSFW.GetMany(waifupicsgo.NSFWNeko.String())
```
### 🔹 `GetOne(category string)`
_Fetches a single random image_ from the given category.
### 🔹 `GetMany(category string)`
_Fetches multiple unique images_ from the given category.
## Categories
- `SFW`: _waifu, neko, shinobu, megumin, bully, cuddle, cry, hug, awooo, kiss, lick, pat, smug, bonk, yeet, blush, smile, wave, highfive, handhold, nom, bite, glomp, slap, kill, kick, happy, wink, poke, dance, cringe_
- `NSFW`: _waifu, neko, trap, blowjob_
Each category is defined as a typed constant and can be passed using `.String()`.
## License
This project is licensed under the **[GNU General Public License v3.0 (GPL-3.0)](https://opensource.org/licenses/GPL-3.0)**.