Loading repository data…
walterwhite-69 / repository
JoylandAI-Discord-API
An unofficial, high-performance Discord API wrapper and Discord Bot for Joyland AI. Bring Joyland AI to Discord! Features immersive webhook character roleplay, persistent stealth sessions, paginated search UIs, and asynchronous, high-speed API performance.
#ai#api#api-wrapper#asyncio#bot#character-ai
Live repository statistics
★ 2Stars
⑂ 1Forks
◯ 0Open issues
◉ 2Watchers
47/100
OPENREPOHUB HEALTH SIGNAL
Mixed signals
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
52
Community adoption25% weight
5
Maintenance state20% weight
100
License clarity10% weight
0
Project information10% weight
75
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
Welcome to the JoylandAI Discord Bot, an immersive and intuitive way to bring Joyland's engaging characters directly into your Discord servers! This bot securely connects to Joyland AI, allowing seamless searching, immersive webhook-powered side-by-side chatting, and robust session persistence.
✨ Features
- 🎭 Immersive Webhook Chat: Characters reply dynamically through Discord Webhooks using their real names and avatars. It directly mimics the Joyland conversational UI right inside your channel.
- 🔐 Persistent, Stealthy Sessions: Every user enjoys a completely isolated session with locally saved credentials (
sessions.json). Features dynamically randomized fingerprints and User-Agent cycling. - 🎨 Beautiful UI: Paginated search interfaces using beautiful, responsive Discord Embeds powered by native UI Views and Buttons.
- ⚡ Asynchronous & Fast: Powered by
httpxandasynciofor zero-blocking, high-speed API communication with Joyland. - 🛠️ Deep Diagnostic Debugging: Detailed API response insights directly embedded inside Discord for seamless troubleshooting.
🚀 Installation & Setup
Prerequisites
- Python 3.8+
- A Discord Developer Application (Bot Token)
1. Clone & Install Dependencies
Clone the repository and install the standard dependencies:
pip install discord httpx
2. Configure Your Bot Token
Open bot.py and replace the placeholder YOUR_DISCORD_BOT_TOKEN at the very bottom of the file with your active Discord Bot Token.
Alternatively, you could extend the logic to load from an environment variable:
token = os.environ.get("DISCORD_TOKEN", "YOUR_DISCORD_BOT_TOKEN")
3. Required Discord Permissions
In the Discord Developer Portal, ensure your bot has the following privileges enabled: