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

# similarity_search

Returns documents most similar to the query text.

```python theme={null}
similarity_search(
    query: str,
    k: int = 4,
    filter: Optional[Dict[str, Any]] = None,
    **kwargs
) -> List[Document]
```

### Parameters

| Parameter  | Type                       | Description                                     |
| ---------- | -------------------------- | ----------------------------------------------- |
| `query`    | `str`                      | Query text to search for                        |
| `k`        | `int`                      | Number of documents to return (default: 4)      |
| `filter`   | `Optional[Dict[str, Any]]` | *(Optional)* Metadata filters to apply          |
| `**kwargs` | `Any`                      | Additional keyword arguments (currently unused) |

### Returns

`List[Document]`: List of most similar Document objects

### Example Usage

```python theme={null}
# Basic similarity search
results = store.similarity_search("machine learning algorithms", k=5)
for doc in results:
    print(f"Content: {doc.page_content[:100]}...")
    print(f"Metadata: {doc.metadata}")

# Search with metadata filter
filter_dict = {"language": "python", "level": "beginner"}
results = store.similarity_search(
    "python tutorial",
    k=3,
    filter=filter_dict
)
```