Skip to content

How do I use TomoriBot?

This guide takes you from scratch to your first message with TomoriBot. Easiest path is to invite the ready public instance (see the Privacy Policy). If you’d rather run your own instance, jump to Self-hosting at the bottom.

Use the Hosted Bot

Step 1: Invite her

Invite the public instance with the button below, then pick the server you want her in. You need the Manage Server permission to add a bot.

You can also DM her directly. The setup steps are the same.

Step 2: Get an API key

TomoriBot doesn’t ship with an AI brain of its own; you connect one from a provider through an API key. She supports many providers, and you only need one to get started. The following are some providers she currently supports:

  • Google Gemini: general-purpose, has a free tier, runs every feature. Recommended for your first setup.
  • OpenRouter: one key, access to all of the latest text, video, image, embedding models.
  • NovelAI: subscription-based, uncensored images, roleplay, and storytelling.
  • DeepSeek, NVIDIA NIM, Anthropic, Vertex AI, Z.ai, or any OpenAI-compatible Custom endpoint.

Run /help in Discord, choose Setup, then Step 1: Get an API Key, and pick your provider to see how to get its API key, or see Providers & Models for the full list.

Step 3: Run Setup

Run /setup. It opens a private checklist panel that only you can operate. Work through its items, then press Finish Setup:

  • AI Provider: choose AI Provider (Recommended), pick your provider, and paste the key in. Advanced self-hosters can pick Custom Endpoint (Advanced) and register their endpoint’s connection and text model here instead, and a server can run with User BYOK (in a server, not a DM) so every member supplies their own personal provider.
  • Starting Settings: pick a starting persona, a reply style, a timezone, and the default system prompt.
  • Policies (hosted instances only): accept the Terms of Service and the Privacy Policy in one modal.

Nothing is saved while you work: the panel is a draft, Finish Setup is what encrypts the key, initializes her configuration for the server, and gets her ready to talk. Cancel discards the draft, and an untouched panel expires on its own. Each server keeps its own independent configuration.

Recommended: run /expressions initialize afterward so she can use your server’s custom emojis and stickers accurately.

Step 4: Start chatting

Just mention her or reply to one of her messages:

@TomoriBot yo, what's up?

From here you can shape how she gets triggered and how she behaves:

On the hosted instance, setting up TomoriBot means you and your server members agree to her /legal terms-of-service and /legal privacy-policy notices; the guided setup asks you to accept both. Those two commands, and the Policies step that carries them, belong to the hosted deployment. A self-hosted instance registers /legal license in every environment and the policy two only under RUN_ENV=production.

Self-hosting

Want full control over your data, models, and API keys? You can run your own TomoriBot instance on your own hardware. The recommended path is the guided setup wizard.