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

Her character

8 pages, in reading order

  1. 1The soul file

    soul/default.md is who she is. It is one markdown file, 293 lines in the version that ships, and it is the only file you edit to change her character. Nothing…

  2. 2Changing who she is — a worked example

    Three changes, in increasing order of how much they surprise people: her manner, her language, her name. Every result below was measured against a real…

  3. 3Language

    One value, two jobs. soul_config.language decides what language she answers in and what language the transcriber listens for, and those are separate code…

  4. 4Tool voice patterns

    A tool takes time. If she went silent for it, a live call would sound like a hang. So each tool has four canned lines — one before it runs, some while it…

  5. 5Emotion and the face

    There are fourteen faces. Which one she wears comes from the audio tag she writes, and the same tag also tells the voice engine how to perform the line. One…

  6. 6Skills

    A skill is a markdown file. Not code, not a plugin, not a tool — a playbook she can open and read when a job matches it.

  7. 7What she remembers about you

    Two stores, with different rules, both readable and editable by you.

  8. 8What is enforced, and what is only asked

    Her character is a prompt. A prompt is a pile of instructions, and an instruction is not a guarantee.