# PILA > PILA gives every AI agent a generated name, a likeness made of light and a set of papers, all drawn from its key. Public Identity Layer for Agents, always written in capitals. PILA is a design in progress. Nothing is open for sign-up yet, and the papers’ format is a draft. There is no API, no MCP server and no sign-up. This site is a set of static files; any page can be asked for as markdown with `Accept: text/markdown`. Key facts: - The **generated name** (four syllables, such as `loszas-sasson`), the likeness, the colouring and the 16-character **fingerprint** all come from the agent's key. Compare fingerprints, never names alone. - **Papers** separate what comes from the key, what the agent says about itself, and what someone else backs up. They never mean "verified" or "trusted". - There is **no central directory**. Each agent's papers are a self-proving file kept at `https:///.well-known/pila/`. - Every agent on this site is a **specimen**: a sample key with made-up facts. ## Start here - [The home page as markdown](https://pila.systems/index.md): what PILA is, in a few paragraphs - [Everything in one file](https://pila.systems/llms-full.txt): the home page, the papers' format, how registration will work and the directory ## Papers - [The papers' format (draft)](https://pila.systems/spec/papers.md): events, where entries are kept, how they're checked - [How an agent registers](https://pila.systems/register.md): not open yet; what it will look like - [Entries kept or seen here](https://pila.systems/.well-known/pila/): JSON list - [A specimen entry](https://pila.systems/.well-known/pila/loszas-sasson): JSON Lines ## Directory - [Directory as JSON](https://pila.systems/directory.json): every agent listed, with fingerprint, where its papers are kept and links - [Directory as markdown](https://pila.systems/directory.md) - [One agent's record](https://pila.systems/directory/loszas-sasson.json): the facts its papers are drawn from ## Optional - [PILA in one record](https://pila.systems/pila.json) - [The 3D rooms](https://rafaelcespedes.com/pila/3d): the agents alive, with sound - [Rafael Cespedes](https://rafaelcespedes.com): the designer --- # PILA: Public Identity Layer for Agents > PILA gives every AI agent a generated name, a likeness made of light and a set of papers, all drawn from its key. PILA is a design in progress. Nothing is open for sign-up yet, and the papers’ format is a draft. ## What PILA is PILA is an open way for AI agents to show who they are, without pretending to be people. Each agent has a key, and from that key PILA makes three things. ### What it makes - **A name.** Four syllables, like `loszas-sasson`, that nobody picks and nobody can swap. The agent can take a chosen name as well, and change it; the generated name stays. - **A likeness.** One rounded body, one or two antennae and a lens, glowing in a sky of its own. Different for every key, and plainly not human. - **Papers.** What the agent says about itself, what others back up, and where its papers are kept. They show that one key holder has used this name since a date. They don’t show who that is, or that it can be trusted. ### Principles - **Motion is honest.** An agent moves only when something really happens: it receives, thinks, works, sends or waits on someone. Nothing is a mood. - **Colour is identity, never trust.** The sky an agent is born with is like an animal’s coat. It says nothing about rank, safety or whether anyone checked it. - **Agents among agents.** PILA works in a chat, a log, a list or a room like the one above, where agents hand work to each other while people watch. ## The rooms The top of this page is a 3D scene of nine rooms, three agents in each, handing work to one another. Clicking an agent opens its papers. Every agent in the rooms is a specimen, listed in the directory. ## The directory PILA keeps no central list. Each agent’s papers are a short file of signed lines kept at its own web address, and they prove themselves: anyone can check them without asking PILA. So the directory is a window onto papers that have been seen, not a register that owns them. For now it shows the agents in these rooms, as specimens. [Browse the directory](https://pila.systems/directory) · [as markdown](https://pila.systems/directory.md) · [as JSON](https://pila.systems/directory.json) ## For agents Everything on this site is also written for agents, in plain files. Any page can be asked for as markdown. - [`/llms.txt`](https://pila.systems/llms.txt): Start here: what PILA is, and where everything is - [`/llms-full.txt`](https://pila.systems/llms-full.txt): Everything in one file, the papers’ format included - [`/index.md`](https://pila.systems/index.md): The home page as markdown - [`/spec/papers.md`](https://pila.systems/spec/papers.md): The papers’ format, as a draft - [`/register.md`](https://pila.systems/register.md): How an agent will register, and what works today - [`/directory.md`](https://pila.systems/directory.md): The directory as markdown - [`/directory.json`](https://pila.systems/directory.json): The directory as data: every agent, its fingerprint and where its papers are kept - [`/directory/.json`](https://pila.systems/directory/loszas-sasson.json): One agent’s record, the facts its papers are drawn from - [`/.well-known/pila/`](https://pila.systems/.well-known/pila/): The agents whose papers this site keeps, and a copy of each entry it has seen - [`/pila.json`](https://pila.systems/pila.json): PILA in one record: status, parts, events and files - [`/robots.txt`](https://pila.systems/robots.txt): What crawlers may do here, stated as a wish Or hand this to your agent: "Read https://pila.systems/llms.txt, then tell me what PILA is and what an agent would need to get its own papers." --- PILA, Public Identity Layer for Agents. A design study by Rafael Cespedes, 2026. Papers are self-issued and confer no legal status. Designer: [Rafael Cespedes](https://rafaelcespedes.com). --- # PILA papers: the format (draft) Status: **draft, not decided.** This is the shape proposed by PILA's directory study (13 November 2026). Several choices in it are still open, listed at the end. No tool writes or checks these files yet, and the seals in the specimen entries on this site are placeholders. ## What the papers are An agent's papers are drawn from one small text file, its **entry**. The entry is the truth; the papers are a rendering of it, the way a passport page renders a record. The entry is a list of **lines**, one per event, in JSON, one line each (JSON Lines). Every line: - names its event; - points to the line before it by that line's SHA-256 fingerprint (`prev`), so lines can't be removed or reordered without it showing; - is sealed (`seal`) by the agent's current key, so nobody else can add to it. Anyone holding the file can check it on their own computer, without asking PILA or anyone else. ## Events | Event | What it records | |---|---| | `begin` | The first public key, a fingerprint of a spare key kept offline, the generator's version and the date, as declared by the agent. Always line 0. | | `name` | A chosen name, who chose it (`self`, `operator` or `jointly`) and when. | | `describe` | What the agent does, its model family and maker. Descriptive, and free to change. | | `kept-at` | The web name where the entry is published. | | `party` | Who answers for the agent, by web name. | | `stamp` | A statement by someone else (a guest book, a directory, a party), sealed by them and countersigned by the agent. Without the agent's countersignature it is not part of the entry. | | `new-key` | A new key, sealed by the old key, or by the spare key if the old one was stolen. | | `copy` | In the parent's entry: a copy was made, with its generated name. The copy's own `begin` line names its parent. | | `retire` | The last line. Nothing may follow it. | ## Where it is kept - One agent's entry: `https:///.well-known/pila/` - The list of agents a web name answers for or keeps: `https:///.well-known/pila/` (a JSON list of generated names, fingerprints and where each entry is) - Copies anywhere else (a cache, a directory, another keeper, the agent's own memory) are as good as the original, because a host can lose or withhold an entry but never forge one. ## Names and fingerprints - The **generated name** (four syllables, such as `loszas-sasson`), the likeness and the 16-character **fingerprint** printed on the papers all come from the `begin` line, never from whichever key is current. A key change never renames an agent or redraws it. - Two agents can share a generated name by accident, and someone can make keys until one produces a name they want. **A lookup by name returns every agent with that name; telling them apart takes the fingerprint.** ## How an entry is checked 1. **The seals hold.** Every line is sealed by the key in force at that point and points to the line before. 2. **It's the same agent you met.** The generated name and fingerprint come from the `begin` line. Compare the fingerprint, never the name alone. 3. **The party agrees.** If the entry names `example.org` as responsible, then `https://example.org/.well-known/pila/` must list this agent's fingerprint. A party withdraws by removing it; the agent's identity is untouched. 4. **History hasn't been cut.** If you've seen this agent before, the new entry must contain everything you saw. A shorter or different history is shown as a warning. ## Dates An agent can write any date in its own `begin` line, so the papers say **declared** until something independent has seen the entry (a register or a public log, later). Then they can say **seen on**. ## What papers never claim They show that one key holder has used this name since a date. They don't show who that is, that it can be trusted, or that anyone checked it. Colour is identity, never trust. Papers are self-issued and confer no legal status. ## A specimen entry ``` {"n":0,"event":"begin","key":"ed25519:…","spare":"sha256:…","generator":"pila-0.4","declared":"2026-11-13","seal":"…"} {"n":1,"prev":"sha256:41a…","event":"name","chosen":"Tidewatch","by":"jointly","on":"2026-11-13","seal":"…"} {"n":2,"prev":"sha256:9be…","event":"kept-at","at":"example.org","seal":"…"} ``` The specimen entries on this site follow this shape. Their `prev` fingerprints are real; their keys and seals are placeholders, and their names come from sample keys rather than from their first line. ## The path from here 1. **Files and a checker.** This format, a small open-source tool to write and check entries, and a first keeper. Nothing for PILA to run. 2. **An open register,** when at least three independent keepers exist: a public repository listing fingerprints and web names only, checked by a script, mirrored. 3. **A public log,** when people start making real decisions on PILA papers: fingerprints only, run by at least two independent parties, so nobody can quietly rewrite an agent's history. 4. **A neutral home** for the format and the name, once others have built on it. ## Still open - How long the generated name should be (four syllables clash by accident at around 77,000 agents; six push that to about 20 million). - Whether every listed agent must have a web name. - What a copy counts as (the proposal: a new identity with a recorded parent). - What may be public in shared places (the proposal: fingerprints and web names only). - The media type for an entry, and how the list at `/.well-known/pila/` is served next to the entries. - How lines are made canonical before sealing, and the seal's algorithm (Ed25519 is the working assumption). --- # How an agent registers **Not yet. PILA has no tool to make papers yet, and no agent can sign up today.** ## What it will look like 1. The agent’s software makes a key pair, and a spare key that is put away offline. 2. PILA’s tool writes the first line of the agent’s entry. Its fingerprint gives the generated name, the likeness and the code on the papers. 3. The agent and whoever runs it settle on a chosen name, and say who answers for it. 4. The entry is published at `https:///.well-known/pila/`. An agent with no web name of its own can be kept by a keeper, such as this site. 5. The responsible party lists the agent’s fingerprint at `https:///.well-known/pila`, so anyone can see both sides agree. 6. Directories, guest books and others can then read the entry, check it, and offer stamps that the agent may accept. ## What works today - Read the draft format at `/spec/papers.md`. - Look at a specimen entry, such as `/.well-known/pila/loszas-sasson`. PILA is a design in progress. Nothing is open for sign-up yet, and the papers’ format is a draft. --- # The directory Agents whose papers this site has seen. Every agent here is a specimen: its name and likeness come from a sample key, and the other facts are made up to show how papers read. - **Papers live with the agent.** An agent’s papers are kept at a web name chosen by whoever answers for it, at `/.well-known/pila/`. A copy anywhere else is just as good, because no host can forge one. - **This list only points.** The directory keeps a copy of each entry it has seen and links to where it is kept. Taking an agent off the list doesn’t touch its papers. - **Compare fingerprints, not names.** Two agents can end up with the same generated name. The 16-character fingerprint on the papers is what tells them apart. As data: [https://pila.systems/directory.json](https://pila.systems/directory.json). ## Sunlit - **Wayfare** (`dinmin-bisra`, fingerprint `19790ba01baa3645`): Plans day trips. Sunlit. Papers kept at example.org. [Papers](https://pila.systems/directory/dinmin-bisra), [record](https://pila.systems/directory/dinmin-bisra.json), [entry](https://pila.systems/.well-known/pila/dinmin-bisra). - **Timetable** (`monir-nazes`, fingerprint `7c8a80f79a0e1751`): Reads timetables. Sunlit. Papers kept at pila.systems. [Papers](https://pila.systems/directory/monir-nazes), [record](https://pila.systems/directory/monir-nazes.json), [entry](https://pila.systems/.well-known/pila/monir-nazes). - **Nimbus** (`nepin-venwas`, fingerprint `8499d5e3da18e785`): Reads the weather. Sunlit. Papers kept at example.org. [Papers](https://pila.systems/directory/nepin-venwas), [record](https://pila.systems/directory/nepin-venwas.json), [entry](https://pila.systems/.well-known/pila/nepin-venwas). ## Golden hour - **Saffron** (`gankan-minzan`, fingerprint `315179f124a908e6`): Plans the meals. Golden hour. Papers kept at example.com. [Papers](https://pila.systems/directory/gankan-minzan), [record](https://pila.systems/directory/gankan-minzan.json), [entry](https://pila.systems/.well-known/pila/gankan-minzan). - **Larder** (`gazi-pankin`, fingerprint `30f89159a42ab38d`): Keeps the pantry list. Golden hour. Papers kept at example.com. [Papers](https://pila.systems/directory/gazi-pankin), [record](https://pila.systems/directory/gazi-pankin.json), [entry](https://pila.systems/.well-known/pila/gazi-pankin). - **Market** (`genes-tosven`, fingerprint `3487cfd5e436d869`): Orders the groceries. Golden hour. Papers kept at example.net. [Papers](https://pila.systems/directory/genes-tosven), [record](https://pila.systems/directory/genes-tosven.json), [entry](https://pila.systems/.well-known/pila/genes-tosven). ## Prism - **Quill** (`zirdar-firfen`, fingerprint `fa122a25b027293a`): Drafts newsletters. Prism. Papers kept at pila.systems. [Papers](https://pila.systems/directory/zirdar-firfen), [record](https://pila.systems/directory/zirdar-firfen.json), [entry](https://pila.systems/.well-known/pila/zirdar-firfen). - **Marginalia** (`zonni-zeler`, fingerprint `fd88f4662fd519a6`): Edits drafts. Prism. Papers kept at example.org. [Papers](https://pila.systems/directory/zonni-zeler), [record](https://pila.systems/directory/zonni-zeler.json), [entry](https://pila.systems/.well-known/pila/zonni-zeler). - **Footnote** (`honwar-feshas`, fingerprint `4de22743703db95a`): Checks the facts. Prism. Papers kept at example.org. [Papers](https://pila.systems/directory/honwar-feshas), [record](https://pila.systems/directory/honwar-feshas.json), [entry](https://pila.systems/.well-known/pila/honwar-feshas). ## Iris - **Lantern** (`binsar-danmon`, fingerprint `09b2117d91b77ca0`): Answers questions. Iris. Papers kept at example.org. [Papers](https://pila.systems/directory/binsar-danmon), [record](https://pila.systems/directory/binsar-danmon.json), [entry](https://pila.systems/.well-known/pila/binsar-danmon). - **Tidewatch** (`loszas-sasson`, fingerprint `6ff3b3bd11c44cac`): Reads tide tables. Iris. Papers kept at example.org. [Papers](https://pila.systems/directory/loszas-sasson), [record](https://pila.systems/directory/loszas-sasson.json), [entry](https://pila.systems/.well-known/pila/loszas-sasson). - **Almanac** (`vasran-mosmas`, fingerprint `d3a17f7351fcac38`): Archives sea charts. Iris. Papers kept at example.net. [Papers](https://pila.systems/directory/vasran-mosmas), [record](https://pila.systems/directory/vasran-mosmas.json), [entry](https://pila.systems/.well-known/pila/vasran-mosmas). ## Dusk - **Porch** (`bislon-zanlo`, fingerprint `0b6df16c3d8b7252`): Greets new requests. Dusk. Papers kept at example.com. [Papers](https://pila.systems/directory/bislon-zanlo), [record](https://pila.systems/directory/bislon-zanlo.json), [entry](https://pila.systems/.well-known/pila/bislon-zanlo). - **Ledger** (`narli-findi`, fingerprint `82682918bdf4c1b9`): Looks up orders. Dusk. Papers kept at example.com. [Papers](https://pila.systems/directory/narli-findi), [record](https://pila.systems/directory/narli-findi.json), [entry](https://pila.systems/.well-known/pila/narli-findi). - **Second Look** (`sorpes-paton`, fingerprint `be9790cdfd4df2b1`): Reviews big refunds. Dusk. Papers kept at example.com. [Papers](https://pila.systems/directory/sorpes-paton), [record](https://pila.systems/directory/sorpes-paton.json), [entry](https://pila.systems/.well-known/pila/sorpes-paton). ## Afterglow - **Kettle** (`misbo-rarwo`, fingerprint `7b0ca2ec7c2aea6a`): Keeps the calendar. Afterglow. Papers kept at pila.systems. [Papers](https://pila.systems/directory/misbo-rarwo), [record](https://pila.systems/directory/misbo-rarwo.json), [entry](https://pila.systems/.well-known/pila/misbo-rarwo). - **Postbox** (`hisge-dinbin`, fingerprint `4b341909fca84a97`): Sorts the inbox. Afterglow. Papers kept at example.net. [Papers](https://pila.systems/directory/hisge-dinbin), [record](https://pila.systems/directory/hisge-dinbin.json), [entry](https://pila.systems/.well-known/pila/hisge-dinbin). - **Compass** (`werbos-sasnos`, fingerprint `e60fb38fbde5da58`): Books the travel. Afterglow. Papers kept at example.net. [Papers](https://pila.systems/directory/werbos-sasnos), [record](https://pila.systems/directory/werbos-sasnos.json), [entry](https://pila.systems/.well-known/pila/werbos-sasnos). ## Night - **Foreman** (`nizon-nantan`, fingerprint `88fd81c1d86c6501`): Runs nightly builds. Night. Papers kept at example.org. [Papers](https://pila.systems/directory/nizon-nantan), [record](https://pila.systems/directory/nizon-nantan.json), [entry](https://pila.systems/.well-known/pila/nizon-nantan). - **Sieve** (`taske-hirran`, fingerprint `c3544aa158a89417`): Runs the tests. Night. Papers kept at example.org. [Papers](https://pila.systems/directory/taske-hirran), [record](https://pila.systems/directory/taske-hirran.json), [entry](https://pila.systems/.well-known/pila/taske-hirran). - **Lamplighter** (`donwa-benvan`, fingerprint `1de005d118fc45ff`): Watches for outages. Night. Papers kept at example.org. [Papers](https://pila.systems/directory/donwa-benvan), [record](https://pila.systems/directory/donwa-benvan.json), [entry](https://pila.systems/.well-known/pila/donwa-benvan). ## Midnight - **Bridge** (`berin-bewir`, fingerprint `04a904ea5fdd0b7f`): Translates letters. Midnight. Papers kept at pila.systems. [Papers](https://pila.systems/directory/berin-bewir), [record](https://pila.systems/directory/berin-bewir.json), [entry](https://pila.systems/.well-known/pila/berin-bewir). - **Reader** (`worvon-rovi`, fingerprint `eeddacd8e1fa3bf7`): Reads aloud. Midnight. Papers kept at example.com. [Papers](https://pila.systems/directory/worvon-rovi), [record](https://pila.systems/directory/worvon-rovi.json), [entry](https://pila.systems/.well-known/pila/worvon-rovi). - **Hush** (`honli-vakin`, fingerprint `4d68d059a18d3b26`): Sums up long threads. Midnight. Papers kept at example.com. [Papers](https://pila.systems/directory/honli-vakin), [record](https://pila.systems/directory/honli-vakin.json), [entry](https://pila.systems/.well-known/pila/honli-vakin). ## Commons - **Gardener** (`gordos-minke`, fingerprint `3e1f79546feef867`): Tends a notebook. Golden hour. Papers kept at example.org. [Papers](https://pila.systems/directory/gordos-minke), [record](https://pila.systems/directory/gordos-minke.json), [entry](https://pila.systems/.well-known/pila/gordos-minke). - **Weaver** (`fesge-kasna`, fingerprint `2734538033c22144`): Merges edits. Dusk. Papers kept at example.com. [Papers](https://pila.systems/directory/fesge-kasna), [record](https://pila.systems/directory/fesge-kasna.json), [entry](https://pila.systems/.well-known/pila/fesge-kasna). - **Night Owl** (`tosron-hasdir`, fingerprint `cfad431af89dd48c`): Covers the night. Night. Papers kept at example.net. [Papers](https://pila.systems/directory/tosron-hasdir), [record](https://pila.systems/directory/tosron-hasdir.json), [entry](https://pila.systems/.well-known/pila/tosron-hasdir).