installation

prerequisites

before diving in, ensure you have the following:

• node.js 18+ and npm installed
• git for cloning the repository
• Discord bot token from the Discord developer portal
• AI backend with an API

AI backend

moemoe requires some sort of AI backend to function and you've plenty of options available:

for local models (recommended)

running a local LLM gives you full control and no API costs, but does require a somewhat beefy PC depending on the model's size. i would recommend koboldcpp for how awesome it is.

quick KoboldCPP setup:

1. download KoboldCPP
2. grab a model that will fit on your PC
3. run KoboldCPP and take note of the URL
   • by default this will be localhost:5001

cloud providers

openai and other provider support is coming soon. for now, local models are the way to go.

bot installation

git clone https://github.com/conjureme/moemoe-discord.git
cd moemoe-discord

npm install

cp .env.example .env

DISCORD_TOKEN=your_bot_token_here
CLIENT_ID=client_id_here
API_PROVIDER=koboldcpp

{
  "maxTokens": 500,
  "temperature": 1.0
}

{
  "name": "moemoe",
  "description": "a friendly and helpful discord bot",
  "data": {
    "system_prompt": "you are moemoe, a helpful discord bot...",
    "first_mes": "hiya! i'm moemoe!",
    "mes_example": "example dialogue here"
  }
}

npm run deploy

npm run dev

inviting moemoe

once running, you'll need to invite moemoe to your server:

1. go to the discord developer portal
2. select your application
3. navigate to OAuth2 > URL Generator
4. select these scopes:
   • bot
   • applications.commands
5. select perms you want or ensure bot has proper roles
6. copy the generated URL and open it to invite moemoe

bot in your server, try these:

• try /ping to verify bot and commands are working
• test AI interaction with @moemoe hello!
• test AI responses to ensure it's acting correctly

troubleshooting

moemoe won't respond

• check that your AI backend is running and accessible
• verify the APIs in .env are correct
• ensure moemoe has permission to read and send messages
• enable debug mode and check terminal output for errors

commands aren't showing

• run npm run deploy or npm run deploy:global again
• refresh discord with CTRL + R and retry
• try deploying to your specific guild instead of globally

AI responses are weird

• ensure config/ai.json is using the right instruction format and sampler settings
• try lowering your temperature

voice support

for voice features, you'll also need:

• @discordjs/voice
• sodium-native
• rvc-python
• KokoroTTS API

whisper transcription

koboldcpp supports running a whisper model in tandem, you can get one from here:

• https://huggingface.co/koboldcpp/whisper/tree/main

next steps

now that moemoe is running:

• configure her personality to match your server or desired character
• explore available commands
• set up your economy system
• create autoresponders