> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# ArXiv
> Search and retrieve academic papers from ArXiv
## Overview
ArXiv is a free distribution service and open-access archive for scholarly articles. This tool allows you to search and retrieve academic papers.
The user asks for research papers; the agent queries ArXiv and returns matching papers.
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
subgraph "ArxivTool Flow"
User[👤 User] --> Agent[🤖 Agent]
Agent --> Tool[🔧 ArxivTool]
Tool --> Result[✅ Result]
Result --> Agent
end
classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff
classDef output fill:#10B981,stroke:#7C90A0,color:#fff
class User,Agent agent
class Tool tool
class Result output
```
## Installation
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install "praisonai[tools]"
```
No API key required!
## Quick Start
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai_tools import ArxivTool
# Initialize
arxiv = ArxivTool()
# Search
results = arxiv.search("transformer neural networks")
print(results)
```
Use the same tool with an agent — see **Usage with Agent** below, or pass env vars and options from the sections above.
## Usage with Agent
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
from praisonai_tools import ArxivTool
agent = Agent(
name="Researcher",
instructions="You are a research assistant. Use ArXiv to find academic papers.",
tools=[ArxivTool()]
)
response = agent.chat("Find papers about large language models")
print(response)
```
## Available Methods
### search(query, max\_results=5)
Search ArXiv for papers.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai_tools import ArxivTool
arxiv = ArxivTool()
results = arxiv.search("deep learning", max_results=3)
# Returns:
# [
# {
# "title": "...",
# "authors": ["..."],
# "summary": "...",
# "published": "2024-01-15",
# "pdf_url": "https://arxiv.org/pdf/..."
# },
# ...
# ]
```
### get\_paper(arxiv\_id)
Get a specific paper by ArXiv ID.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
paper = arxiv.get_paper("2301.00234")
# Returns full paper details including abstract and links
```
## Configuration Options
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
arxiv = ArxivTool(
sort_by="relevance", # "relevance" or "submittedDate"
sort_order="descending" # "ascending" or "descending"
)
```
## Function-Based Usage
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai_tools import arxiv_search
# Quick search without instantiating class
results = arxiv_search("quantum computing", max_results=5)
```
## CLI Usage
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Use with praisonai (no API key needed)
praisonai --tools ArxivTool "Find recent papers on reinforcement learning"
```
## Error Handling
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai_tools import ArxivTool
arxiv = ArxivTool()
results = arxiv.search("my query")
if results and "error" in results[0]:
print(f"Error: {results[0]['error']}")
else:
for paper in results:
print(f"- {paper['title']}")
print(f" Authors: {', '.join(paper['authors'][:3])}")
```
## Common Errors
| Error | Cause | Solution |
| --------------------- | ------------------ | ------------------------- |
| `arxiv not installed` | Missing dependency | Run `pip install arxiv` |
| `No results found` | Query too specific | Broaden search terms |
| `Connection error` | Network issue | Check internet connection |
## How It Works
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
participant User
participant Agent
participant Tool as Tool
participant Svc as ArXiv API
User->>Agent: Request
Agent->>Tool: Call tool
Tool->>Svc: Query
Svc-->>Tool: Data
Tool-->>Agent: Result
Agent-->>User: Response
```
***
## Best Practices
Use `search` to find candidate papers first, then fetch full details only for the ones you need. This keeps token usage low.
Filter by ArXiv category (e.g. `cs.AI`) so the agent works with relevant papers instead of the whole corpus.
ArXiv results are stable — cache them locally when the same query runs often to avoid redundant API calls.
***
## Related Tools
General knowledge
Medical research
Neural search