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

# Turbopuffer

> Use Turbopuffer as a vector store through a community-maintained adapter

Turbopuffer is a high-performance vector database designed for fast similarity search at scale.

<Note>
  Cognee can use Turbopuffer as a [vector store](/setup-configuration/vector-stores) backend through this [community-maintained](/setup-configuration/community-maintained/overview) adapter.
</Note>

## Installation

This adapter is a separate package from core Cognee. Before installing, complete the [Cognee installation](/getting-started/installation) and ensure your environment is configured with [LLM and embedding providers](/setup-configuration/overview). After that, install the adapter package:

```bash theme={null}
pip install cognee-community-vector-adapter-turbopuffer
```

## Configuration

1. Create an account at [turbopuffer.com](https://turbopuffer.com)
2. Get your API key from the [dashboard](https://turbopuffer.com/dashboard)

Set the following environment variables in your `.env` file:

```dotenv theme={null}
TURBOPUFFER_API_KEY="your_api_key"
VECTOR_DATASET_DATABASE_HANDLER="turbopuffer"
# Optional: defaults to gcp-us-central1
# TURBOPUFFER_REGION="gcp-us-central1"
```

Then register the adapter in your code:

```python theme={null}
from cognee_community_vector_adapter_turbopuffer import register
```

See [available regions](https://turbopuffer.com/docs/regions) for supported `TURBOPUFFER_REGION` values.

## Important Notes

<Accordion title="Embedding Dimensions">
  Ensure `EMBEDDING_DIMENSIONS` matches your embedding model. See [Embedding Providers](/setup-configuration/embedding-providers) for configuration.

  Changing dimensions requires recreating collections or running `prune.prune_system()`.
</Accordion>

## Resources

<CardGroup cols={2}>
  <Card title="Turbopuffer Docs" icon="book" href="https://turbopuffer.com/docs">
    Official documentation
  </Card>

  <Card title="Adapter Source" icon="github" href="https://github.com/topoteretes/cognee-community/tree/main/packages/vector/turbopuffer">
    GitHub repository
  </Card>
</CardGroup>

<Columns cols={3}>
  <Card title="Vector Stores" icon="database" href="/setup-configuration/vector-stores">
    Official vector providers
  </Card>

  <Card title="Community Overview" icon="users" href="/setup-configuration/community-maintained/overview">
    All community integrations
  </Card>

  <Card title="Setup Overview" icon="settings" href="/setup-configuration/overview">
    Configuration guide
  </Card>
</Columns>