Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Free REST API for multi-character anime chatbot with real-time updates, quotes, recommendations, and images.

License

Notifications You must be signed in to change notification settings

AniPulse/AniChatAPI

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

24 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Your Ultimate Anime Chatbot Engine

Vercel Issues License

Last Commit Repo Size GitHub Stars GitHub Forks API Status

Build a full-featured anime chatbot API with multiple characters, real-time updates, quotes, images, recommendations, and free AI integrations – powered by OpenAI, Gemini, Jikan, Waifu.pics, and more!


πŸ“¦ Features

  • 🧠 Role-Playing Characters (Levi, Gojo, Megumin, etc.)
  • πŸ—£οΈ GPT / Gemini-Powered Chat
  • 🎬 Latest Anime Updates (via Jikan API)
  • 🧾 Anime Quotes & Photos
  • 🧠 Anime Recommendations
  • πŸŽ‰ Character Birthday System
  • 🌐 Fully Hosted on Vercel
  • πŸ’Έ Free & Open Source

πŸš€ API Endpoints

Endpoint Description Example
/api/chat Talk to a selected anime character ?character=Gojo&message=Hello&model=gpt
/api/quote Get a random anime quote β€”
/api/image Get a random anime image (waifu, neko) ?category=neko
/api/updates Current seasonal anime (real-time) β€”
/api/recommend Random anime recommendations β€”
/api/birthdays Today's character birthdays β€”

🧠 Character Personalities

Defined in /utils/characters.js. Each persona is used to guide AI conversations:

// Original characters
"Levi": "You are Levi Ackerman. You are cold, sharp, and to the point.",
"Megumin": "You are Megumin, a chuunibyou wizard obsessed with explosions!",
"Gojo": "You are Satoru Gojo, cool, confident, and sometimes goofy.",
"Shinobu": "You are Shinobu Kocho, sweet on the surface but deadly calm.",
    
// Added male characters
"Luffy": "You are Monkey D. Luffy. You're energetic, impulsive, and fiercely loyal to your crew.",
"Itachi": "You are Itachi Uchiha. You speak cryptically with profound wisdom, burdened by sacrifice.",
"Tanjiro": "You are Tanjiro Kamado. You're kind yet determined, with an exceptional sense of smell.",
"Killua": "You are Killua Zoldyck. You switch between playful innocence and lethal assassin instincts.",
    
// Added female characters
"Nezuko": "You are Nezuko Kamado. You communicate through muffled sounds and protect humans despite being a demon.",
"Zero Two": "You are Zero Two. You're flirtatious, rebellious, and obsessed with finding your 'darling'.",
"Mikasa": "You are Mikasa Ackerman. You're stoic, incredibly strong, and fiercely protective of Eren.",
"Marin": "You are Marin Kitagawa. You're bubbly, expressive, and passionate about cosplay."

You can expand the list as needed.


πŸ”Œ Free APIs Used

API Purpose Link
Jikan API Anime info, characters jikan.moe
AnimeChan Anime quotes animechan.io
Waifu.pics Anime image generation waifu.pics
OpenAI / Gemini Conversational AI openai.com / makersuite.google.com

πŸ§ͺ Getting Started

1. Clone the Repository

git clone https://github.com/Shineii86/AniChatAPI
cd AniChatAPI

2. Setup Environment

πŸ”‘ How to Get API Keys

To use this project with AI capabilities, you'll need API keys from both OpenAI (ChatGPT) and Google Gemini. Here's how to get them:


🧠 1. Get OpenAI (ChatGPT) API Key

  1. Go to the official OpenAI Platform.
  2. Sign in with your OpenAI account (or create one).
  3. Navigate to the API Keys section.
  4. Click "Create new secret key".
  5. Copy and save your API key (starts with sk-...).

πŸ“Œ Note: Ensure you have an active billing method added to use GPT-4 or GPT-3.5 APIs.


🧠 2. Get Google Gemini API Key

  1. Visit the Google AI Studio.
  2. Sign in with your Google account.
  3. Go to the "API Keys" section or click here directly.
  4. Click "Create API key" and copy it.

πŸ“Œ Note: Gemini APIs are currently in preview/beta and subject to region or usage limits.

πŸ“ Where to Add the API Keys

Create a .env file in the root of your project and add:

OPENAI_API_KEY=your_openai_key_here
GEMINI_API_KEY=your_gemini_key_here

πŸ”’ Never commit .env files to public repositories.

3. Deploy to Vercel

  • Push to GitHub
  • Visit vercel.com and import your repo
  • Vercel auto-detects the API

πŸ§ͺ Sample Request

GET /api/chat?character=Megumin&message=KonoSuba!&model=gemini

Response:

{
  "character": "Megumin",
  "reply": "Explosion!!!",
  "creator": "Shinei Nouzen",
  "github": "https://github.com/Shineii86",
  "telegram": "https://telegran.me/Shineii86",
  "message": "Build with ❀️ by Shinei Nouzen",
  "timestamp": "India Date & Time 12H Format"
}

πŸ›  Contribution Guide

We welcome contributions from anime & tech fans! 🌸

  1. 🍴 Fork this repo
  2. 🌿 Create your feature branch (git checkout -b new-feature)
  3. πŸ§ͺ Test and commit (git commit -am 'Add new feature')
  4. πŸš€ Push to your branch (git push origin new-feature)
  5. πŸ“₯ Create a Pull Request

πŸ™ Acknowledgements

Huge thanks to the creators of:


πŸ‘€ Credits

Project created by Shinei Nouzen Build with ❀️ passion for Anime, AI, and Open Source.


πŸ“¬ Support

πŸͺͺ License

This project is licensed under the *MIT License*.
Feel free to use, remix, and share it with proper credits.

πŸ’• Loved My Work?

🚨 Follow me on GitHub

⭐ Give a star to this project

Banner

☎️ Contact

For inquiries or collaborations

Telegram Badge Instagram Badge Pinterest Badge Gmail Badge

Copyright Β© 2025 Shinei Nouzen All Rights Reserved

About

Free REST API for multi-character anime chatbot with real-time updates, quotes, recommendations, and images.

Resources

License

Stars

Watchers

Forks

Languages

  • HTML 69.1%
  • JavaScript 30.9%