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

# Valyu

> ValyuTools provides academic and web search capabilities with advanced filtering and relevance scoring.

## Prerequisites

The following example requires the `valyu` and `openai` libraries and an API key from [Valyu](https://platform.valyu.network).

```shell theme={null}
uv pip install -U valyu openai
```

```shell theme={null}
export VALYU_API_KEY=***
```

## Example

The following agent can perform academic and web searches:

```python theme={null}
from agno.agent import Agent
from agno.tools.valyu import ValyuTools

agent = Agent(
    instructions=[
        "You are a research assistant that helps find academic papers and web content",
        "Use Valyu to search for high-quality, relevant information",
        "Provide detailed analysis of search results with relevance scores",
        "Focus on credible sources and academic publications",
    ],
    tools=[ValyuTools()],
)

agent.print_response("Find recent research papers about machine learning in healthcare", stream=True)
```

## Toolkit Params

| Parameter                | Type                  | Default | Description                                                                   |
| ------------------------ | --------------------- | ------- | ----------------------------------------------------------------------------- |
| `api_key`                | `Optional[str]`       | `None`  | Valyu API key. Uses VALYU\_API\_KEY if not set.                               |
| `enable_academic_search` | `bool`                | `True`  | Enable academic sources search functionality.                                 |
| `enable_web_search`      | `bool`                | `True`  | Enable web search functionality.                                              |
| `enable_paper_search`    | `bool`                | `True`  | Enable search within paper functionality.                                     |
| `all`                    | `bool`                | `False` | Enable all tools. Overrides individual flags when True.                       |
| `text_length`            | `int`                 | `1000`  | Maximum length of text content per result.                                    |
| `max_results`            | `int`                 | `10`    | Maximum number of results to return.                                          |
| `relevance_threshold`    | `float`               | `0.5`   | Minimum relevance score for results.                                          |
| `content_category`       | `Optional[str]`       | `None`  | Content category for filtering.                                               |
| `search_start_date`      | `Optional[str]`       | `None`  | Start date for search filtering (YYYY-MM-DD).                                 |
| `search_end_date`        | `Optional[str]`       | `None`  | End date for search filtering (YYYY-MM-DD).                                   |
| `search_domains`         | `Optional[List[str]]` | `None`  | Currently has no effect. The value is stored but never sent to the Valyu API. |
| `sources`                | `Optional[List[str]]` | `None`  | List of specific sources to search.                                           |
| `max_price`              | `float`               | `30.0`  | Maximum price for API calls.                                                  |
| `tool_call_mode`         | `bool`                | `False` | Pass `is_tool_call=True` to the Valyu search API.                             |

## Toolkit Functions

| Function                  | Description                                                    |
| ------------------------- | -------------------------------------------------------------- |
| `search_academic_sources` | Search academic sources for research papers and publications.  |
| `search_web`              | Search web sources for general information and content.        |
| `search_within_paper`     | Search within a specific ArXiv paper for detailed information. |

## Developer Resources

* [Tools Source](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/valyu.py)
* [Valyu API Documentation](https://docs.valyu.ai/overview)
* [Academic Search Best Practices](https://docs.valyu.ai/use-cases/academic)