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 1 of 13

Start

7 pages, in reading order

  1. 1What Kotoba is

    Kotoba is an AI companion that runs on your own machine. She has an anime face that lip-syncs and changes expression, real-time two-way voice, and a full…

  2. 2Requirements

    Two of these are awkward and get stated first, because finding them out after you have installed is worse.

  3. 3Installing

    Kotoba is one Python package, kotoba-companion. It needs Python 3.11 or newer and nothing else.

  4. 4First run

    Two commands. The first configures her, the second starts her.

  5. 5kotoba doctor

    kotoba doctor is the command to run when something will not start. It checks this machine in the order that decides whether she can run at all, and a check…

  6. 6Installing from a clone

    Do this if you want to change Kotoba. If you only want to run her, pip install is simpler and gives you a compiled web UI you do not have to build.

  7. 7Troubleshooting the first hour

    Run kotoba doctor first. It is designed for exactly this and it names most of what follows. These are the cases where the report is not enough, or where the…

Start with What Kotoba isAll sections