Marketplace
Browse the Broker / Recipe / Flow assets published on the official relay (
api.familiars.cn): check the author, download count, likes and tips — then download them or join the interaction right in the browser.
What you'll see here
The explorer above shows live runtime data (each page visit pulls the latest index from the official relay) and supports three asset types:
| Type | What it is | Where it installs |
|---|---|---|
| Broker | Installable desktop app bundle (.broker.zip, with sha256 + Ed25519 signature) | Desktop client → Broker workshop → Marketplace page install |
| Recipe | Single-skill recipe (an automation playbook that solves one class of task) | Desktop client → Creative workshop → Recipe list |
| Flow | Cross-agent flow orchestration (multi-role concurrent collaboration workflows) | Desktop client → Flow editor → My flows |
Each card shows: cover thumbnail, name, author, description, category, downloads / views / likes / tips (VTP), size, version and sha256.
Interact (like / tip / report)
- The first time you click 👍 Like / 🪙 Tip / 🚩 Report, the browser will prompt to generate a local account key (Ed25519 keypair);
- This key lives only in the current browser's
localStorage— it is never uploaded or registered, and can be deleted at any time; after deletion, past likes/tips can no longer be attributed to you; - Every interaction signs the request with this key (WebCrypto
crypto.subtle); the relay verifies the signature before recording, and one account can like a given asset only once; - Tips: amount must be an integer ≥ 1; it is credited to the author's relay point account (no real monetary value — it exists to incentivize authors);
- Report: a reason is required; submissions enter the relay's report queue for manual review by the admins.
❓ If the browser does not support WebCrypto Ed25519 (older browsers), the signed interactions will ask you to use the desktop client instead; browsing and downloading do not depend on an account key and always work.
Data & privacy
- Asset data comes from the official relay:
GET https://api.familiars.cn/marketplace/{index | recipes/index | flows/index}; - Thumbnails and download packages are served from the official CDN (
/marketplace/cover/…/thumb,/marketplace/download/…); - The marketplace page does no tracking of any kind — the only write operation is the signed interaction you initiate yourself.
Want to publish your own assets?
- The marketplace uses the Broker development toolchain (
python main.py broker keygen/pack/sign/publish) to package and sign locally, then publish to the official relay; - Full tutorial: BROKER_DEVELOPMENT.md in the repo (also mounted site-side under Broker development).
Deep feedback
Want to report a bug / request a feature / ask about usage? Head to the Ventaris guild "Familiar" and create a task (see Feedback) — it goes through the full review flow with a 20 VTP reward.