> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolmena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and Manage Marketplace Listings

> Install an agent or swarm from the Kolmena Marketplace. Start a free trial, buy a one-time license, or subscribe monthly. Manage, update, or cancel your rentals anytime.

Installing a listing from the Kolmena Marketplace adds a private copy of an agent or swarm to your workspace. You can start with a free trial when one is available, buy a one-time license, or subscribe monthly. This page covers how to install a listing, manage your rental, and leave a review.

## Install a listing

<Steps>
  <Step title="Find a listing">
    Browse the [Marketplace](/marketplace) and open a listing that interests you. Read the description, sales pitch, and screenshots to understand what it does.
  </Step>

  <Step title="Choose your plan">
    The install dialog shows the pricing model: free, one-time purchase, or subscription. If a free trial is available, you can start it immediately. If you already used the trial for this listing, the dialog warns you that installing now begins paid billing right away.
  </Step>

  <Step title="Confirm and install">
    Click the install button. A private copy is added to your agents or swarms. For agents, an API key is generated so you can call the agent from outside Kolmena. For swarms, a copy of the full team is created.
  </Step>

  <Step title="Save your API keys">
    After installation, the dialog shows your API keys once. Copy and save them immediately. You can regenerate keys later from the agent detail page if needed.
  </Step>
</Steps>

## What happens after installation

When you install a listing, Kolmena locks the identity, persona, examples, and skills of the original agent or swarm. You cannot edit those parts, but you can set your own plugin credentials so the agent connects to your accounts.

For subscriptions, you keep access until the current billing period ends if you cancel. One-time purchases are yours permanently. Free listings have no billing at all.

## Manage or cancel a rental

You control your rentals from the detail page of the copied agent or swarm:

* **Cancel subscription** - Open the agent or swarm and click **Manage subscription**. Canceling stops future billing and keeps access until the period ends. There are no refunds.
* **Resubscribe** - If a subscription expires, a **Resubscribe** button appears to restart it.
* **Pull updates** - When the creator releases an update, a **Pull update** button appears. Applying the update brings in the latest version while preserving your credentials.
* **Renew** - For expired rentals, you can renew to regain full access.

## Leave a review

After you have used a listing, you can rate and review it to help other users:

1. Open the listing page in the Marketplace.
2. Click **Leave a review**.
3. Select a star rating from 1 to 5.
4. Write a short review, up to 300 characters.
5. Click **Submit Review**.

You can edit or delete your review at any time from the same listing page.

## Next steps

<CardGroup cols={2}>
  <Card title="Marketplace overview" color="#FE4F32" icon="store" href="/marketplace">
    Browse categories, pricing models, and review features.
  </Card>

  <Card title="Sell on the Marketplace" color="#FE4F32" icon="tag" href="/marketplace/sell-on-the-marketplace">
    Learn how to list your own agents and swarms for others to install.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.