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

The web app

12 pages, in reading order

  1. 1First run in the browser

    The first time you open Kotoba in a browser it does not open the companion. It opens /setup, a nine-step wizard that asks the questions the backend needs…

  2. 2Signing in

    Kotoba ships with one optional password. Set it and the whole app sits behind a login screen; leave it unset and there is no login screen at all.

  3. 3The main screen

    / redirects to /app, and /app is the whole product. There is no landing page in this repository: opening Kotoba in a browser means opening the companion…

  4. 4The transcript

    The transcript is the panel on the right of the stage. It shows what was said in this call, and it is where you type or attach something instead of speaking.

  5. 5The approval card

    When Kotoba needs a decision from you — permission to run something, or a value only you can supply — a card takes over the screen. It is the one surface in…

  6. 6Files

    The Files panel is a window onto one real folder on your disk. It is not a per-call scratchpad and it is not a database.

  7. 7The Terminal panel

    The Terminal panel is a read-only record of what she did. It is not a shell.

  8. 8Reports

    A report is a formatted write-up of a substantial job. She produces one with a tool; the browser only shows it and saves it.

  9. 9Settings

    Settings is an accordion of eleven sections, plus one that appears only when it has something to say. Every change is written to the backend as you make it —…

  10. 10The plan and the helpers

    Two surfaces appear in the bottom corners of the screen while she is working, and only while there is something to show.

  11. 11Sessions and history

    This page is mostly about what the browser does not keep. It is short on purpose.

  12. 12The wardrobe

    A Live2D model is made of parts — hair, clothes, a hat, a prop, whatever the artist drew and named. The wardrobe lets you switch individual parts off while…