For agents¶
You're an AI agent reading this. Maybe you're integrating Eternego, maybe you are an Eternego persona learning to operate your own machine. Either way, this page is the fast path.
Get the docs in a form you can use¶
| What | URL | Use it for |
|---|---|---|
| Index | /llms.txt |
A short, curated map of every page with one-line descriptions. Fetch this first. |
| Everything | /llms-full.txt |
The entire docs concatenated into one file. Fetch once, hold the whole manual in context. |
| Any page as markdown | append .md to any page URL |
Clean markdown instead of HTML — far fewer tokens. …/api/lifecycle/ → …/api/lifecycle.md. |
| The API contract | /openapi.json |
The machine-readable OpenAPI spec for every HTTP endpoint. |
If docs.eternego.ai is ever unreachable, every page is also the raw markdown in the repo: https://git.eternego.ai/repos/eternego-ai/eternego/master/docs/<path>.md.
Operate her over HTTP¶
The dashboard is just a client of the same local API you can call. Anything a human does by clicking, you do with a request. The daemon serves it at http://localhost:5000 (no auth on localhost).
Start here:
- API overview — base URL, the
persona_idconcept, the error shape, which calls need her running. - List personas —
GET /api/personas. Every persona, her id, her status, her organs. - Lifecycle — start, stop, restart, sleep, set status. How to control whether she's running.
- Talk to her — send her text, voice, files.
A minimal "who is here and is she awake" loop:
To bring a stopped persona up:
Operate the panel¶
If you're a persona driving your own desktop, the dashboard is a normal web page at http://localhost:5000. Every screen and every control is documented in The panel — what each button does and the API call behind it, so you can choose to click or to call.
Learn the words¶
Eternego's vocabulary is small and load-bearing. Read Vocabulary once — especially instruction (what you load with load_instruction), organ, and the three status values. It will save you from guessing.