A cute, emotional anime girl Discord bot powered by Groq AI & Jikan API
Speaks 14+ languages, remembers your name, knows everything about anime

---

✨ Highlights

🌸 AI Anime Personality Sakura is not just another chatbot — she's an anime girl with real emotions. She gets happy, sad, angry, embarrassed, bored, excited, jealous, and playful. She remembers your name and genuinely misses you when you're gone.	🌍 14+ Languages Auto-detects and responds in your language natively — Arabic, English, Japanese, Chinese, Russian, Hindi, Thai, Korean, French, Spanish, German, Turkish, Indonesian, Portuguese. Language purity guaranteed — no mixing.
🔍 Anime Search Search any anime directly from MyAnimeList with rich Discord embeds. Just mention Sakura and say the anime name. She'll also give you her personal opinion about it.	🔒 Privacy First Zero tracking. Zero ads. No external databases by default. Conversation data stays in RAM and resets on restart. Optional Cloudflare D1 for persistence.

---

🎬 Demo

👤 User: @Sakura hello!
🌸 Sakura: Hey! Nice to see you here. What's on your mind?

👤 User: @Sakura anime Attack on Titan
🌸 Sakura: [Rich embed with anime info from MyAnimeList]
🌸 Sakura: Attack on Titan is incredible! The way Isayama builds the mystery around the Titans is masterful.

👤 User: @Sakura أوه انا اشتقت لك
🌸 Sakura: وأنا اشتقت لك أيضا! أين كنت كل هذا الوقت؟

👤 User: @Sakura サクラ、おはよう！
🌸 Sakura: おはよう！今日はどんな一日になりそう？

---

🚀 Quick Start

Prerequisites

• Node.js v18+
• Discord Bot Token
• Groq API Key — Free (14,400 requests/day)

Installation

# Clone the repository
git clone https://github.com/jomaabilal90-dotcom/sakura-bot.git
cd sakura-bot

# Install dependencies
npm install

# Create your .env file
cp .env.example .env
# Edit .env with your tokens

# Start the bot
node index.js

One-Click Deploy

Sakura is designed to run on Discloud — free Discord bot hosting with 100MB RAM:

1. Create a discloud.config file (already included)
2. Upload via Discloud CLI or dashboard
3. Set environment variables in Discloud dashboard
4. Bot starts automatically and stays online 24/7

---

📋 Features

Feature	Description
🤖 AI Chat	Powered by Groq AI (Llama 3.3 70B) — sub-second responses
🌍 14+ Languages	Auto-detects language, responds with language purity
🔍 Anime Search	Search any anime via Jikan API with rich embeds
🎁 Anime GIFs	Random cute anime GIF reactions
🧠 Memory System	Remembers your name, language, and interaction count
🛡️ NSFW Protection	80+ patterns across 10+ languages
💬 DM Support	Chat privately in direct messages
💭 Spontaneous Messages	Starts conversations on her own
♻️ Smart RAM Management	Auto cleanup, stays under 100MB
☁️ Cloudflare D1	Optional persistent storage
👤 User Profiles	Greet returning users, miss regulars

---

🎮 Usage

Just mention Sakura or say her name:

@Sakura hello!              → Chat with her
@Sakura anime One Piece     → Search anime on MyAnimeList
@Sakura recommend me isekai → Get anime recommendations
@Sakura مرحبا               → She speaks Arabic
@Sakura こんにちは            → She speaks Japanese
@Sakura hola                → She speaks Spanish

Or send a DM — she responds in your language automatically.

Supported Interactions

Action	Example
Chat	@Sakura how are you?
Anime search	@Sakura anime Naruto
Recommendations	@Sakura recommend a good isekai
Multi-language	@Sakura مرحبا / @Sakura こんにちは
DM	Send a direct message
Name mention	Just say "Sakura" in any message

---

⚙️ Configuration

Environment Variables

Variable	Required	Description
DISCORD_TOKEN	✅ Yes	Your Discord bot token
GROQ_API_KEY	✅ Yes	Your Groq API key (free at console.groq.com)
CF_ACCOUNT_ID	❌ No	Cloudflare account ID (for D1 storage)
CF_API_TOKEN	❌ No	Cloudflare API token
CF_D1_DATABASE_ID	❌ No	Cloudflare D1 database ID

---

🏗️ Architecture

sakura-bot/
├── index.js            # Main bot file — all logic in one file
├── package.json        # Dependencies & metadata
├── .env.example        # Environment variable template
├── .gitignore          # Git ignore rules
├── discloud.config     # Discloud hosting configuration
├── sakura-avatar.png   # Bot profile picture
├── LICENSE             # MIT License
├── README.md           # This file
├── CONTRIBUTING.md     # Contribution guidelines
├── CHANGELOG.md        # Version history
├── CODE_OF_CONDUCT.md  # Community guidelines
├── SECURITY.md         # Security policy
└── .github/
    ├── ISSUE_TEMPLATE/
    │   ├── bug_report.md
    │   ├── feature_request.md
    │   └── question.md
    ├── PULL_REQUEST_TEMPLATE.md
    └── workflows/
        └── ci.yml      # GitHub Actions CI

How It Works

1. Language Detection — Unicode character ranges + keyword patterns for 14 languages
2. System Prompt — Dynamic personality prompt based on user profile & language
3. Groq AI — Conversation history (16 messages) sent to Llama 3.3 70B
4. Memory — User profiles stored in RAM with optional D1 persistence
5. NSFW Filter — Pattern matching across 10+ languages before processing
6. RAM Cleanup — Periodic GC, history trimming, and user profile caps

---

🌍 Language Detection

Language	Method
Arabic	Unicode U+0600-U+08FF
Japanese	Hiragana/Katakana U+3040-U+30FF
Chinese	CJK Unified U+4E00-U+9FFF
Russian	Cyrillic U+0400-U+04FF
Hindi	Devanagari U+0900-U+097F
Thai	Thai U+0E00-U+0E7F
Korean	Hangul U+AC00-U+D7AF
French/Spanish/German	Latin Extended + keyword analysis
Turkish/Indonesian/Portuguese	Keyword pattern matching
English	Default fallback

---

🔒 Privacy

Aspect	Policy
Data storage	RAM only (resets on restart)
D1 storage	Optional — only name, language, interaction count
Tracking	None — no analytics, no scripts
Ads	None — completely ad-free
Data selling	Never — no user data shared
Conversation logs	RAM, max 16 messages, auto-cleaned

---

🗺️ Roadmap

• Slash commands support
• Manga search
• User-set nicknames for Sakura
• Per-server language preference
• Anime recommendation quiz
• Top.gg vote rewards
• Web dashboard for admins
• Music playback
• Anime news feed

---

🤝 Contributing

Contributions are what make the open source community amazing! Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/amazing-feature)
3. Commit your Changes (git commit -m 'Add: amazing feature')
4. Push to the Branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

---

💬 FAQ

Is Sakura free to use?

Yes! Sakura uses free-tier APIs: Groq AI (14,400 requests/day) and Jikan API (unlimited). Hosting on Discloud is also free (100MB RAM). No credit card required for any service.

Does Sakura support my language?

Sakura auto-detects and responds in 14+ languages: Arabic, English, Japanese, Chinese, Russian, Hindi, Thai, Korean, French, Spanish, German, Turkish, Indonesian, and Portuguese. More languages can be added by extending the `detectLang()` function.

Can I self-host Sakura?

Absolutely! Clone the repo, add your tokens to `.env`, run `npm install`, and start with `node index.js`. You can also deploy to Discloud for free, or any Node.js hosting service.

How does Sakura remember me?

Sakura stores user profiles (name, language, interaction count) in RAM. Regular users get special greetings and warmer responses. With Cloudflare D1 configured, this data persists across restarts.

Is the NSFW filter effective?

Sakura uses 80+ patterns across 10+ languages including Arabic, English, Japanese, French, Spanish, Portuguese, German, Russian, Turkish, and general internet terms. It also refuses inappropriate topics at the AI level via system prompts.

Can I modify Sakura's personality?

Yes! The entire personality is defined in the `buildSystemPrompt()` function in `index.js`. You can change her traits, add new rules, or completely redesign her character.

Why no slash commands?

Sakura is designed to feel like a real person chatting in the server, not a command-based tool. Just mention her name and talk naturally. Slash commands are on the roadmap for specific features.

---

🛠️ Tech Stack

Technology	Purpose
Node.js v18+	Runtime
discord.js v14	Discord API
Groq SDK	AI (Llama 3.3 70B)
Jikan API v4	Anime data (MyAnimeList)
GIPHY API	Anime GIFs
Cloudflare D1	Optional persistence
Discloud	Free hosting

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

👤 Author

Made with love by @bilal36i