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!
- π§ 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
| 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 | β |
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.
| 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 |
git clone https://github.com/Shineii86/AniChatAPI
cd AniChatAPITo use this project with AI capabilities, you'll need API keys from both OpenAI (ChatGPT) and Google Gemini. Here's how to get them:
- Go to the official OpenAI Platform.
- Sign in with your OpenAI account (or create one).
- Navigate to the API Keys section.
- Click "Create new secret key".
- 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.
- Visit the Google AI Studio.
- Sign in with your Google account.
- Go to the "API Keys" section or click here directly.
- Click "Create API key" and copy it.
π Note: Gemini APIs are currently in preview/beta and subject to region or usage limits.
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.
- Push to GitHub
- Visit vercel.com and import your repo
- Vercel auto-detects the API
GET /api/chat?character=Megumin&message=KonoSuba!&model=geminiResponse:
{
"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"
}We welcome contributions from anime & tech fans! πΈ
- π΄ Fork this repo
- πΏ Create your feature branch (
git checkout -b new-feature) - π§ͺ Test and commit (
git commit -am 'Add new feature') - π Push to your branch (
git push origin new-feature) - π₯ Create a Pull Request
Huge thanks to the creators of:
Project created by Shinei Nouzen Build with β€οΈ passion for Anime, AI, and Open Source.
- Issues: GitHub Issues
This project is licensed under the *MIT License*.
Feel free to use, remix, and share it with proper credits.π¨ Follow me on GitHub
β Give a star to this project