Metadata-Version: 2.4
Name: lfx-exa
Version: 0.1.0
Summary: Exa web-search and contents tools (exa-py SDK) as a standalone Langflow Extension Bundle.
Project-URL: Homepage, https://github.com/langflow-ai/langflow
Project-URL: Documentation, https://docs.langflow.org/extensions
Project-URL: Repository, https://github.com/langflow-ai/langflow
Author-email: Langflow <contact@langflow.org>
License: MIT
Keywords: bundle,exa,extension,langflow,lfx,search
Requires-Python: <3.15,>=3.10
Requires-Dist: exa-py<3,>=1.14
Requires-Dist: langchain-core<2.0.0,>=1.2.28
Requires-Dist: lfx<2.0.0,>=1.11.0.dev0
Description-Content-Type: text/markdown

# lfx-exa

[Exa](https://exa.ai/) web-search and contents tools as a standalone
Langflow Extension Bundle.

## What it ships

One component, registered under the `exa` bundle group:

- **Exa Search** (`ExaSearchToolkit`, canonical ID
  `ext:exa:ExaSearchToolkit@official`) — a toolkit exposing two tools for
  a Langflow **Agent** component or MCP client:
  - `search` — search the web with Exa (`auto` / `fast` / `instant` /
    `deep` search types, category, domain allow/deny lists, published-date
    range), returning token-efficient highlights by default.
  - `get_contents` — fetch highlights and/or full text for result IDs
    returned by `search`.

The component is built on the [`exa-py`](https://pypi.org/project/exa-py/)
SDK. It previously shipped inside the manifest-less `lfx-bundles`
metapackage on the deprecated `metaphor-python` client; the bundle name and
class name are unchanged, so saved flows load without migration changes.
The legacy `metaphor_api_key` field is still honored (hidden) — new flows
should use `exa_api_key`.

## Install

```bash
pip install lfx-exa
```

`pip install langflow` already includes it.

## Develop

The bundle is a uv workspace member of the Langflow monorepo:

```bash
uv sync
uv run pytest src/bundles/exa/tests -q
uv run lfx extension validate src/bundles/exa/src/lfx_exa
```

To iterate on the component with a live palette:

```bash
uv run lfx extension dev src/bundles/exa
```
