Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/developer51709/Niko/llms.txt

Use this file to discover all available pages before exploring further.

Niko is a warm, café-themed Discord bot built on discord.py 2.3. He speaks English, German, and Spanish, remembers each user’s conversation history, and comes loaded with 76 slash commands spanning AI chat, a tiered economy system, Lavalink music, full-featured moderation, giveaways, leveling, casino games, and more — all wrapped in a polished Components v2 UI.

Introduction

Learn what Niko is, what makes him unique, and how the cog system is structured.

Quickstart

Clone the repo, configure your token, and get Niko running in under 5 minutes.

Environment Variables

Full reference for every .env variable — tokens, AI keys, cooldowns, and more.

AI Providers

Plug in OpenAI, OpenRouter, Groq, or any OpenAI-compatible endpoint.

Explore by Feature

AI & Chat

Conversational AI with memory, favorability scoring, and image generation.

Economy

Jobs, bank vaults, shop, lottery, achievements, and rich PIL wallet cards.

Moderation

Kick, ban, warn, mute, purge, AutoMod dashboard, and raid protection.

Music

Lavalink playback with YouTube, Spotify, Last.fm autoplay, and a live now-playing card.

Leveling

Per-message XP, role rewards, leaderboards, and an interactive level panel.

Community

Giveaways, tickets, polls, suggestions, starboard, birthdays, and social notifiers.

Getting Started

1

Clone and install

Clone the repository and install Python dependencies with pip install -r requirements.txt.
2

Configure your environment

Copy src/.env.example to src/.env and fill in at minimum DISCORD_BOT_TOKEN and your AI provider credentials.
3

Run the bot

Start Niko with python src/bot.py. On first run, slash commands sync globally and all cogs load automatically.
4

Invite to your server

Generate an OAuth2 invite link with bot and applications.commands scopes from the Discord Developer Portal, then invite Niko to your server.
Niko requires Python 3.10+, a Discord Bot Token, and (optionally) an OpenAI-compatible API key for the AI chat and image generation features. See the Quickstart for the full setup walkthrough.

Build docs developers (and LLMs) love