Documentation Index
Fetch the complete documentation index at: https://noradocs.solomontsao.com/llms.txt
Use this file to discover all available pages before exploring further.
Agent Hub
A catalog of reusable agent templates that operators can publish to their workspace, share to a community hub, and install with one click.Agent Hub is Nora’s template marketplace. A listing captures everything needed to recreate an agent — runtime family, deploy target, sandbox profile, image, environment overrides, integrations, and bootstrap files — and exposes it as a one-click install in any workspace that has access. Operators publish listings from existing agents; consumers install listings into their own workspace.
Listing types
| Source type | Where it lives | Visibility |
|---|---|---|
| Built-in | Seeded by Nora at startup | Visible to every workspace. |
| Workspace | Published by an operator from one of their agents | Visible to the publishing workspace. |
| Community | Synced from the configured upstream Agent Hub source | Visible to every workspace once approved. |
NORA_AGENT_HUB_URL (default https://nora.solomontsao.com).
Sharing model
Each workspace listing has ashareTarget:
| Share target | Internal workspaces | Community catalog |
|---|---|---|
internal | ✅ | ❌ |
community | ❌ | ✅ |
both | ✅ | ✅ |
community or both triggers a sync to the upstream hub. The upstream review state is mirrored back into centralShareStatus (not_shared, pending, approved, rejected). Reviewers in the upstream hub can request changes, and the listing’s centralError surfaces the reason.
Versions
A listing has one or more versions. Each version captures:- A reference to the source agent’s snapshot (image, env, files, integrations).
- A
cloneMode:files_only(recommended) orimage_and_files. - A monotonic
versionNumber.
Reports and moderation
Workspaces can report community listings for abuse or licensing concerns. Reports go through the upstream hub’s moderation queue. Rejected listings are hidden from the catalog but stay visible to the publishing workspace for context.Permissions
| Capability | Required role |
|---|---|
| Browse internal + community listings | viewer |
| Install a listing into the workspace | editor |
| Publish, edit, or unpublish a workspace’s listing | admin |
| Manage the source-catalog API key | admin |
Agent Hub source-catalog API keys are stored hashed (HMAC with
NORA_AGENT_HUB_API_KEY_HASH_SECRET). Rotating the secret invalidates every issued key.Related
Workspaces
Workspace ownership and RBAC roles.
Agent Hub guide
Walk through publishing and installing a listing.