# Marketplace — find and publish shared agents, tools and providers

A part of the website where people publish exported .bylm.json files and anyone can browse and download them. You move the file between the site and the app yourself, or let Publish in the app open it in your browser; the app never contacts the marketplace.

Status: Shipped

The marketplace is a part of the website: a place to publish the `.bylm.json` file an
[export](/docs/features/sharing#exporting) writes, and to find files other people published. It is a site
you visit in a browser, not a service the app calls. You download a file from it and
[import](/docs/features/sharing#importing) that file into the app, or you export a file from the app and
upload it here. Publish in the app's export review saves that step: it opens the publish page in
your browser with the file already filled in. Nothing passes between the two by any other route.

## Why it matters

A good agent is usually more than a prompt: a fetch tool with the right headers, a filter that
shapes its answer, the model settings that made it behave. Sharing a file by hand reaches the
people you already know. The marketplace puts that setup where anyone can find it, read every
setting before downloading, and import it with the same review the app gives any file.

## Browsing and downloading

Reading the marketplace and downloading from it need no account.

- **Lists by kind.** Agents, tools and providers each have their own list, in three orders:
  _Latest_, _Top starred_ and _Most downloaded_. Each list offers the tags its kind carries, and
  picking tags narrows it.
- **Namespaces.** Everything a publisher shares sits under their username, at
  `/marketplace/@<username>`, and can be narrowed by tag there too.
- **A listing's page** shows the current release's full configuration: an agent's system prompt
  and settings, a tool's address, a provider's kind and address. It lists the secrets and
  constants an import will ask you for, with a link to where a key can be got when the publisher
  gave one, and what else the download brings along, such as the tools an agent attaches. Each
  earlier release has a page of its own.
- **Download release** hands you the release as a `.bylm.json` file. On Android, opening that file
  from the browser's downloads goes straight to the import plan; anywhere else, open it from
  **Settings → Import**. The import asks you about every provider, model, secret and host before
  anything is written, exactly as for a file a friend sent.
- **Download counts** count each address once per release a day, so repeating a download does not
  move a listing up _Most downloaded_. A download also brings along everything the release pins;
  those listings show it separately, as downloads of other listings they came along with, stacked
  in a lighter shade on the daily chart, and it does not move them up _Most downloaded_.
- **Stars are public.** A listing's page links to who starred it, and an account's page lists what
  it starred, each with the date.

The **Bundle format** page, linked from the footer, describes every field a file may hold, with
its type, whether it is required, and its limits. The JSON Schema it is built from is published at
`/schema/bundle/v1.json`.

## Signing in

Publishing, starring and tagging need an account. **Sign in with Google** or **Sign in with
GitHub**; the first sign-in asks for a username, which names your namespace and cannot be changed
later. Signing in with the other provider under the same verified address reaches the same account.
From your account page you can connect the other provider whatever address it holds, or disconnect
one, as long as another way to sign in remains. Signing in accepts the
[marketplace terms](/terms); what the site keeps about you is in the
[website privacy policy](/website-privacy).

## Publishing

Publish from the **Publish** page, linked from the account menu and your namespace's page: choose a
`.bylm.json` file the app exported, or open the page from the app's Publish button, which fills the
file in for you. Each agent, tool
and provider in it becomes a listing of yours, and uploading the file again later publishes the
next release of each one that changed.

- **The file is checked as the app checks an import.** A file the app would not accept is not
  published, and the page says what the app's review would say about it. A file in a later bundle
  format than the site reads is refused with a note saying so. There are limits on a file's size,
  on how many listings one namespace holds and on how many releases it publishes a day; an upload
  past one is refused with the limit it would cross.
- **Every upload waits for a moderator.** Nobody but you and the moderators sees it until a
  moderator approves it. While it waits, you can take it back from its page under your account.
  A moderator approves or refuses the whole upload, and a refusal says why. To ask again, upload
  the file again, changed.
- **Once approved, everything in the file is public** and dedicated to the public domain under
  CC0: anyone can read and download it. That includes each agent's system prompt, whose first line
  shows on its card, and every tool's address and description. Secrets never travel in a file, so
  none reaches the marketplace, but read the prompt and descriptions with that in mind.
- **Taking it back.** You can withdraw a listing from every list and restore it, or remove a
  release for good. Files people already downloaded stay with them.
- **Tags.** You tag your own listings, and the form suggests words already in use. A word a
  moderator has approved shows to everyone at once; a new word shows only to you, marked as
  awaiting review, until a moderator approves it, and a refused word cannot be added.

## Moderation

Moderators approve or refuse uploads and new tag words, and can hide a listing or a release that
was approved, with a reason its owner reads on its page. An admin can suspend an account, with a
reason the account sees on its own page; a suspended account can only take its own work down, and
nothing it uploaded is approved while the suspension holds. To report something, or to contest a
decision about your own listing or account, write to the address in the
[marketplace terms](/terms).

## What it doesn't do yet

- There is no search; browse by kind, namespace, tag and order.
- There is no report button on a listing; reports go by email, as the terms say.
- A listing has no change note, and every approved listing appears in the lists.
- Nothing verifies who wrote a file beyond the account that published it. Read a listing's
  configuration before importing it, and import what you would run.
- An item imported from a marketplace download carries the publishing account's ids rather than
  the ones it had on the device that exported it, so it is not recognised as the same item as a
  copy imported from the original file. The import offers **Replace** for an agent of the same
  name.

More in [Features](/docs/features): [Providers — bring your own LLM](/docs/features/providers) · [On-device models — run fully offline](/docs/features/embedded-models) · [Agents — the thing you build](/docs/features/agents) · [Tools — giving an agent more than the model knows](/docs/features/tools) · [Workspaces — keep your work in scopes](/docs/features/workspaces) · [Conversations — how a turn runs](/docs/features/conversations) · [Attachments — images and files in a message](/docs/features/attachments) · [Context management — what the model still sees](/docs/features/context-management) · [Background turns — replies that keep running](/docs/features/background-turns) · [Local-first & private by design](/docs/features/local-first) · [Sync — your data across your devices](/docs/features/sync) · [Sharing — move agents, tools and providers as a file](/docs/features/sharing) · [Running a Couchbase Edge Server](/docs/features/couchbase-edge-server) · [Spell checking — catch typos while you write](/docs/features/spell-check)

---

[Bring Your LM](/) · [Docs](/docs/features) · [Marketplace](/marketplace)

[Articles](/articles) · [Releases](/releases) · [Bundle Format](/marketplace/bundle-format) · [Marketplace Terms](/terms) · [App Privacy](/privacy) · [Website Privacy](/website-privacy) · [Open Source](/open-source) · [llms.txt](/llms.txt)