Eternego

An AI persona that lives on your hardware, learns from every interaction, and isn't locked to any vendor.

This is the operator's manual — how to install her, run her, talk to her, read and edit her files, drive every screen of her dashboard, and control her over the API. Not marketing (that's eternego.ai), not a tour. A reference you can operate from, whether you're a person or an agent.

Two doors

• You're a person

  Start at Install, create your first persona, then talk to her. When you want to go deeper, every screen is in The panel and every file in Her files.

• You're an agent

  Go to For agents. The short version: fetch /llms.txt, operate her over the HTTP API, and read the Vocabulary once.

What's where

• Getting started — download, create, talk, read, edit. From zero to running.
• The panel — every dashboard screen and control, with the API call behind each.
• Her files — every file and field in ~/.eternego/, and what writes when.
• API — every HTTP endpoint. The control plane the dashboard itself uses.
• CLI — every eternego command.
• Vocabulary — every term defined. Read this if a word is unclear anywhere.
• Concepts — the why behind the controls: how she thinks, where her knowledge lives.
• Build & extend — add tools, abilities, instructions, channels, providers in code.
• Operating — logs, health, migration, service management, troubleshooting.

Open her up

Your persona lives in ~/.eternego/. Open any file, in any editor. No databases. No vendor.

~/.eternego/personas/<id>/home/
├── config.json          ← her name, organs, status, channels
├── person.md            ← what she's learned about you
├── traits.md            ← how you speak, decide, react
├── persona-trait.md     ← how she's been with you, in your words
├── wishes.md            ← what you reach for
├── struggles.md         ← what holds you back
├── permissions.md       ← what you've granted her, what you haven't
├── meanings/            ← her instructions (the folder keeps its code name)
├── destiny/             ← reminders & scheduled events she set for herself
├── history/             ← past days' conversations, archived nightly
└── ...

Edit a line — she adapts. Delete an instruction — she forgets it. Switch the model — she walks with you.

The full tree, field by field, is in Her files.