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.
This Privacy Policy explains what data Niko collects from Discord users, how it is stored and used, and your rights regarding that data.
This policy applies to the official hosted Niko instance. Self-hosters are
responsible for their own data practices and should publish their own policy
appropriate to their deployment.
What Data We Collect
Niko stores only what is strictly necessary to provide its features. Only Discord User IDs are stored as keys to associate per-user data — no usernames, display names, avatars, or join metadata are ever stored.
The following specific data categories are persisted:
| Data category | Storage location | Notes |
|---|
| Economy data — coin balance, bank balance, inventory, job, transaction log | data/economy_data/{user_id}.json | Per-user file keyed by User ID |
| XP / level | data/levels.json | Per-guild, per-user |
| Warning records | data/warnings.json | User ID + reason + timestamp, per guild |
| Reminders | data/reminders.json | User ID + reminder text + trigger timestamp |
| Highlights / keywords | data/highlights.json | User ID + keyword list |
| Birthday (MM-DD only) | data/birthdays.json | No birth year is stored |
| AI conversation history | memory.json | Last 3 turns per user; also stores long-term memory notes and favorability scores, keyed by User ID |
| Poll votes | data/polls.json | Voter User IDs stored alongside vote counts |
| Suggestion authors | data/suggestions.json | Author User ID stored with suggestion text and vote counts |
| Giveaway entries | data/database.db (SQLite) | Participant User IDs, host User ID, prize, end time |
Data We Do NOT Collect
Niko explicitly does not collect or store the following:
- Passwords or authentication credentials
- Email addresses
- Usernames or display names
- Message content permanently — with two narrow exceptions:
- AI conversation history: the last 3 message turns per user are kept in
memory.json to provide the LLM with short-term context
- Snipe cache: one deleted or edited message per channel is held in memory only and is cleared every time the bot restarts
- Presence or activity data permanently — presence is read in real time only (e.g., for
/userinfo) and is never written to disk
How Data Is Used
All data is used exclusively to run Niko’s features within Discord. Niko never sells, shares, or transfers your data to third parties. Specific uses are:
- Economy data — to power coin balances, job progression, the shop, lottery, and leaderboard features
- XP / level — to provide leveling progression and to assign level-based role rewards
- Warning records — to maintain per-server moderation logs accessible to server staff
- Reminders — to send scheduled DMs to users at their requested time
- Highlights — to scan messages for user-registered keywords and send DM notifications on matches
- Birthdays — to post birthday announcements in configured channels on the correct date
- AI memory — to give the LLM short-term conversational context for more natural, coherent replies
Third-Party Services
Certain Niko features send data to external services. Details are below:
| Service | Data sent | Purpose | Privacy policy |
|---|
| OpenAI API | User message text + short anonymised channel context (≤ 3 prior turns) | AI reply generation | openai.com/policies/privacy-policy |
| Lavalink nodes | Search queries and stream URLs | Music playback | Varies by node operator |
| Last.fm API | Artist and track names | Autoplay — finding similar tracks | last.fm/legal/privacy |
| Gelbooru / Rule34 (optional) | Search tags only | Image search results | No user data is transmitted |
Privacy practices for self-operated Lavalink nodes vary by node operator. If
you are self-hosting Niko, you are responsible for the privacy posture of any
Lavalink node you connect to.
Data Retention
Data is retained until it is explicitly deleted by the user or a server administrator. There is no automatic expiration, with one exception: AI conversation history is capped at the last 3 turns per user and is automatically overwritten as new messages arrive.
You can delete your own data at any time using the corresponding in-bot commands:
| Data | Command to remove |
|---|
| AI conversation history | /clearhistory |
| Reminders | /reminder remove |
| Highlights / keywords | /highlight clear |
| Birthday | /birthday remove |
| Warning records (server admin only) | /clearwarnings |
Your Rights
- Right to access — use
/profile, /memory, /reminders, /highlight list, and /warnings to view the data Niko has stored about you.
- Right to deletion — use the removal commands listed above, or contact the bot operator to request full deletion of all data linked to your User ID.
- Right to data portability — contact the bot operator to request an export of all data associated with your User ID.
You can also view this policy at any time directly inside Discord with the /legal privacy command (ephemeral — visible only to you).