Kotoba

Where to start

What Kotoba isWho she is and where she runs, in one page
InstallingOne package, two commands
First runA key, a model, her first words
The approval gateHow she asks before she acts
The two voice modesLocal voice, or the agent tunnel
The soul fileChange who she is
RoadmapWhat grows next, and what was cut on purpose

Or a section

↑↓ move openesc close124 pages
All pages

Documentationsection 5 of 13

Discord

10 pages, in reading order

  1. 1Kotoba on Discord

    Discord is one of her front doors. The bot, the terminal and the web app run the same engine, read the same database and use the same workspace. What Discord…

  2. 2Setting her up on Discord

    Three things happen on Discord's side: you create the application, you turn on the two intents she asks for, and you invite her with the permissions you want…

  3. 3Installing, the token, and the settings

    From a clone the extra is pip install -e "api/[discord]".

  4. 4When she answers, and what she writes

    A bot that answers every line in a busy channel is a bot people mute. In a server she reads everything and answers five things.

  5. 5The permission model

    This is the heart of the Discord surface. A public channel is the one place where the person talking to her is not the person who runs her, so what a turn may…

  6. 6Changing the server

    Four tools, all of them behind Discord's own Administrator permission on the person asking. See The permission model for how that is decided.

  7. 7Voice in a room

    discord_voice is a tool she holds, so you ask her in words: "come into voice", "join the vc". With no channel named she joins the one you are in — which is…

  8. 8What she remembers about people

    Two stores, kept deliberately apart.

  9. 9Honest limits

    Everything on this page is a thing she does not do. Read it before you promise any of it to the people in your server.

  10. 10When she does not answer

    The bot logs under kotoba.discord. It records sizes and ids, never the words: whoever runs her needs to see that turns are happening and how big they are, and…