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

# Python SDK — marketplace

> Python SDK reference for the Kataven marketplace — browse and install pre-built agent templates.

`MarketplaceClient` is reachable on every Kataven client as `client.marketplace`. Each method maps to one HTTP endpoint on the [Hub API](/api-reference/introduction); links to the underlying spec entry are inline below.

Browse pre-built agent templates and install them into your account. Installed agents are independent — edits don't propagate from the template.

## Methods at a glance

| Method       | HTTP                                                 | Summary                                       |
| ------------ | ---------------------------------------------------- | --------------------------------------------- |
| `list`       | `GET /api/marketplace/agents`                        | List marketplace agent templates              |
| `get`        | `GET /api/marketplace/agents/{template_id}`          | Get a marketplace agent template              |
| `install`    | `POST /api/marketplace/agents/{template_id}/install` | Install a marketplace template as a new agent |
| `categories` | `GET /api/marketplace/categories`                    | List marketplace categories                   |

## Reference

### `client.marketplace.list(...)`

List marketplace agent templates

**HTTP** — `GET /api/marketplace/agents` · [API reference →](/api-reference/introduction#tag/Marketplace/operation/getApiMarketplaceAgents)

```python theme={null}
    def list(
        self,
        category: Optional[str] = None,
        search: Optional[str] = None,
        limit: int = 10,
        offset: int = 0,
    ) -> Dict[str, Any]:
```

### `client.marketplace.get(...)`

Get a marketplace agent template

**HTTP** — `GET /api/marketplace/agents/{id}` · [API reference →](/api-reference/introduction#tag/Marketplace/operation/getApiMarketplaceAgentsById)

```python theme={null}
    def get(self, template_id: str) -> Dict[str, Any]:
```

Returns the full template — system prompt, voice config, attached tools and playbooks.

### `client.marketplace.install(...)`

Install a marketplace template as a new agent

**HTTP** — `POST /api/marketplace/agents/{id}/install` · [API reference →](/api-reference/introduction#tag/Marketplace/operation/postApiMarketplaceAgentsByIdInstall)

```python theme={null}
    def install(self, template_id: str, name: Optional[str] = None) -> Dict[str, Any]:
```

Creates a new agent in the caller's account from the template, copying its prompts, voice config, attached playbooks and FAQs. Optionally renames it.

### `client.marketplace.categories(...)`

List marketplace categories

**HTTP** — `GET /api/marketplace/categories` · [API reference →](/api-reference/introduction#tag/Marketplace/operation/getApiMarketplaceCategories)

```python theme={null}
    def categories(self) -> Dict[str, Any]:
```

Returns the set of category labels that have at least one published marketplace template, with counts.