booru-api

Setup Instructions

Production Environment

1. Clone the repository:

   git clone https://git.creations.works/creations/booru-api
   cd booru-api
   

2. Copy the example environment file to .env:

   cp .env.example .env
   

3. Start the application in detached mode:

   docker compose up -d
   

---

Development Environment

1. Clone the repository:

   git clone https://git.creations.works/creations/booru-api
   cd booru-api
   

2. Copy the example environment file to .env:

   cp .env.example .env
   

3. Install dependencies using Bun:

   bun install
   

4. Start the development server:

   bun dev
   

---

Note

To use the e621 API, you must update the following environment variables in your .env file:

E621_USER_AGENT=YourApplication/1.0 (by username on e621)
E621_USERNAME=your-username
E621_API_KEY=your-apikey

Replace your-username and your-apikey with your e621 account credentials. Update the User-Agent string to include your application name, version, and a contact method (e.g., your e621 username) to comply with e621's API guidelines.

To use the Gelbooru API, you must also update the following:

GELBOORU_API_KEY=your-apikey
GELBOORU_USER_ID=your-user-id

You can find these credentials in your Gelbooru account settings. These are required for authenticated API requests and higher rate limits.