🖥️ AGAC API

_{The anime-girls-and-computers API!}

This is an API for anime-girls-and-computers github repo.

🌐 Publicly available instances

Country	URL	Hosted by	Notes
🇳🇱	https://api.ananas.moe/agac/v1	bananas	Official Instance
🇩🇪	https://agac.teaishealthy.me	teaishealthy	Tee 🍵
🇺🇸	https://api.emmatech.dev/agac	EmmmaTech	Instance hosted with help from Ananas

🛠️ Self-Host

How to host your own AGAC API instance

🐬 Docker Method (recommended)

1. Pull the image

docker pull r3tr0ananas/agac-api:latest

2. Then launch a container with this command.

you don't really need to mount a volume but it's recommended

docker run -p 8000:8000/tcp -v ./cached_images:/app/assets/cache r3tr0ananas/agac-api:latest

3. Now visit localhost:8000 in your browser and there you go!

if you wanna use docker-compose, this file might be useful to you

🐍 Native Method (recommended for development)

Prerequisites:

• Git
• Python (3.8+)
• Make (otherwise you'll have to copy the commands from the Makefile)

1. Clone the repo.

git clone https://codeberg.org/bananas/agac-api && cd agac-api

2. Create env.

python -m venv env
source env/bin/activate # For windows it's --> cd env/Scripts && activate && cd ../../

3. Install the API's dependencies.

make

4. Pull the anime girls images.

make get-repo

5. Run.

make run

6. Visit localhost:8083 in your browser, then all should be good!