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

# ArXiv

> Learn how to use the ArXiv integration with Julep

## Overview

Welcome to the ArXiv integration guide for Julep! This integration allows you to access a vast repository of scientific papers and articles, enabling you to build workflows that require academic research data. Whether you're developing a research assistant or need scholarly articles for analysis, this guide will walk you through the setup and usage.

## How to Use the Integration

To get started with the ArXiv integration, follow these steps to configure and create a task:

<Steps>
  <Step title="Define Your Search Parameters">
    Use the following YAML configuration to define your search parameters and request data from ArXiv:

    ```yaml ArXiv Search Example theme={"dark"}
    name: ArXiv Search
    tools:
    - name: arxiv_search
      type: integration
      integration:
        provider: arxiv
        method: search
    main:
    - tool: arxiv_search
      arguments:
        query: machine learning
        max_results: 10
        download_pdf: False
        sort_by: relevance
        sort_order: descending
    ```
  </Step>
</Steps>

### YAML Explanation

<AccordionGroup>
  <Accordion title="Basic Configuration">
    * ***name***: A descriptive name for the task, in this case, "ArXiv Search".
    * ***tools***: This section lists the tools or integrations being used. Here, `arxiv_search` is defined as an integration tool.
  </Accordion>

  <Accordion title="Tool Configuration">
    * ***type***: Specifies the type of tool, which is `integration` in this context.
    * ***integration***: Details the provider and setup for the integration.
      * ***provider***: Indicates the service provider, which is `arxiv` for ArXiv.
      * ***method***: Indicates the method to be used, which is `search` for ArXiv. If not specified, the method will be `search` by default.
  </Accordion>

  <Accordion title="Workflow Configuration">
    * ***main***: Defines the main execution steps.
      * ***tool***: Refers to the tool defined earlier (`arxiv_search`).
      * ***arguments***: Specifies the input parameters for the tool:
        * ***query***: The search query for the ArXiv search.
        * ***max\_results***: (optional) The maximum number of results to return. Defaults to 5.
        * ***download\_pdf***: (optional) Return base64 encoded pdfs. Defaults to False.
        * ***sort\_by***: (optional) The sorting criterion for the results. Defaults to "relevance".
        * ***sort\_order***: (optional) The sorting order for the results. Defaults to "descending".
  </Accordion>
</AccordionGroup>

<Note>
  Customize the `query` and other parameters to suit your specific search needs.
</Note>

## Conclusion

With the ArXiv integration, you can easily access a wealth of academic papers and articles.
This integration provides a robust solution for accessing scholarly data, enhancing your workflow's research capabilities and user experience.

<Tip>
  For more information, please refer to the [ArXiv API documentation](https://arxiv.org/help/api/index).
</Tip>