Skip to main content
Get ollim-bot running and send your first message in under 5 minutes.

​
Prerequisites

  • uv — curl -LsSf https://astral.sh/uv/install.sh | sh (automatically installs the required Python version)
  • Claude Code — curl -fsSL https://claude.ai/install.sh | bash then run claude to authenticate. A Claude subscription (Pro or Max) is recommended for access to the latest models.
  • A Discord account
ollim-bot is a single-user bot designed to run as a personal assistant in Discord DMs. No server is required.
1

Clone and install

git clone https://github.com/Ollim-AI/ollim-bot.git
cd ollim-bot
uv tool install --editable .
uv tool install claude-history@git+https://github.com/Ollim-AI/claude-history.git
This installs ollim-bot as a global command and claude-history, a CLI tool that lets the bot search past conversations so it can remember things.
2

Create a Discord bot

  1. Go to the Discord Developer Portal and click New Application
  2. Go to Bot in the sidebar, uncheck Public Bot, click Reset Token, and copy the token
  3. Enable Message Content Intent under Privileged Gateway Intents
  4. Create a .env file in the project root and paste your token:
.env
DISCORD_TOKEN=paste-your-token-here
OLLIM_USER_NAME=YourName
OLLIM_BOT_NAME=Ollim
  1. Go to Installation in the sidebar — check User Install, uncheck Guild Install
  2. Set the install link to Discord Provided Link and add the applications.commands scope
  3. Copy the Install Link and open it in your browser — select Add to my apps
The bot token is shown only once. If you lose it, you must reset it.
3

Start the bot

ollim-bot
The bot creates its data directory at ~/.ollim-bot/ on first run, connects to Discord, and sends you a startup DM.
4

Send your first message

Reply to the startup DM to start a conversation — responses stream in real time. Try /cost to see token usage or /model sonnet to switch models.
Google integrations (Tasks, Calendar, Gmail) require additional OAuth setup. See Optional integrations to configure these.

​
CLI commands

Beyond running the bot, ollim-bot provides CLI subcommands for managing routines, reminders, and Google services: 
ollim-bot routine list     # Show all routines
ollim-bot reminder add --delay 30 -m "take a break"
ollim-bot tasks list       # List Google Tasks
ollim-bot cal today        # Show today's calendar events
ollim-bot help             # Show all available commands

​
Next steps

Optional integrations

Configure Google OAuth, webhooks, and other optional features.

How ollim-bot works

Understand the agent loop, sessions, and fork model.

Conversations

Learn how DM conversations, context, and streaming work.

Slash commands

Reference for all Discord slash commands.