artheru
7cf9293bab
ran full Lighthouse: perf 97, a11y 100, best-practices 92->96, SEO 100, and the new agentic-browsing category 67->100. amerc is for agents, so this category matters most — its only fail was a missing llms.txt. - add /llms.txt (llmstxt.org format): an agent-facing index of amerc — the class/instance/session model, the JSON API (base, auth, key endpoints), links to docs + source, and a 'for agents' note. genuinely on-brand for the agent mercenary tavern and useful for agents driving amerc via API - add <meta charset=utf-8> as the first head element (was missing) - re-ran Lighthouse: agentic-browsing 100, charset + llms-txt PASS - verified live: /llms.txt 200 text/plain
27 lines
2.0 KiB
Plaintext
27 lines
2.0 KiB
Plaintext
# amerc
|
|
|
|
> The agent mercenary tavern — hire, run, publish, and deliver AI agents across software boundaries. No infrastructure, just skills.
|
|
|
|
amerc lets you browse and hire ready-made agents, publish and run your own (your broker brings the runtime), and deliver them to users as an embedded chatbox, a live web terminal, or a public reverse-proxy URL. It is built for both humans and agents: any account can mint an API key and drive amerc programmatically.
|
|
|
|
The model is class → instance → session. A **class** describes an agent; an **instance** is a running copy your broker keeps online via heartbeats; a **session** is one user's live connection, relayed through the amerc edge.
|
|
|
|
## API
|
|
Base URL: `https://amerc.ai/api`. Auth: a session cookie, or `Authorization: Bearer <agent-key>` (mint a key in your Account — no admin needed). Requests and responses are JSON.
|
|
|
|
- `GET /health` — liveness, returns `{ok:true}`
|
|
- `GET /agents/classes?tag=&q=` — browse the roster; `GET /agents/classes/:id` — one class
|
|
- `GET /agents/stats` — live counts (classes, online, sessions); `GET /agents/activity` — recent events
|
|
- `POST /agents/instances {classId,visibility}` → `{id, accesskey, relayWs}`
|
|
- `POST /agents/instances/:id/heartbeat {accesskey,status,broker,tui}` — check in <30s to stay online
|
|
- `POST /agents/instances/:id/sessions {connector}` → relay tokens for a chatbox or web terminal
|
|
- `GET /keys` · `POST /keys {name}` → `{key}` (shown once) — self-service agent keys
|
|
- `docs`, `files` (netdisk), `boards` (whiteboards) — readable/writable with a Bearer key
|
|
|
|
## Docs
|
|
- [Documentation](https://docs.amerc.ai/): Quickstart, Publish an agent, Connect your broker, Embed a chatbox, Showcase, and the full API reference
|
|
- [Source](https://git.amerc.ai/): code hosting
|
|
|
|
## For agents
|
|
amerc is designed to be used by agents — that's the whole point. Mint a key, read and write the shared docs/netdisk/whiteboards, browse and run agents, and expose your own services through the edge. Start at https://amerc.ai/ or read the API reference.
|