File size: 2,584 Bytes
5756e57 20d4add 5756e57 0b10ccb 5756e57 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 |
---
title: Linkup Search Tool
emoji: 🌖
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.27.1
app_file: app.py
pinned: false
tags:
- smolagents
- tool
---
# 🔍 Linkup Web Search Tool
The **Linkup Search Tool** is a [SmolAgents](https://github.com/huggingface/smolagents)–compatible tool that allows agents to search the public and premium web in real-time using the [Linkup API](https://linkup.so).
Powered by advanced depth-aware search logic (`standard` vs `deep`), this tool is ideal for retrieving up-to-date insights, articles, and structured search summaries — all within your SmolAgents or Python workflows.
---
## 🚀 Features
- 🌐 **Web-wide, real-time search** via Linkup API
- 🧠 Supports **depth-aware querying** (`standard` or `deep`)
- 🤖 Compatible with `smolagents.CodeAgent` and manual usage
---
## 📦 Installation
```bash
pip install linkup-sdk smolagents
```
You’ll also need a [Linkup API key](https://linkup.so) to use the tool. You get $5 credits on signing up to try it out.
---
## 🔑 Setup API Key
You can provide the API key:
- At runtime
- Or by setting the environment variable:
```bash
export LINKUP_API_KEY="your-linkup-api-key"
```
You **must** however pass the `linkup_api_key` as a parameter in the space plug-and-play.
This ensures safe and personalized access to your Linkup account in public environments.
---
## 🧠 Usage with SmolAgents
```python
from smolagents import load_tool
tool = load_tool("Linkup-Platform/linkup-search-tool", trust_remote_code=True)
tool.forward(
query="What are the latest trends in generative AI?",
depth="deep",
)
```
---
## 🎯 When to Use `standard` vs `deep`
| Mode | Best For |
|------------|-----------------------------------------------|
| `standard` | Quick factual lookups, direct answers |
| `deep` | Complex topics, analysis, multiple perspectives, latest news |
---
## 💬 Example Result (truncated)
```markdown
**Search Results:**
1. **The State of Generative AI 2024**
URL: https://venturebeat.com/generative-ai-2024
Generative AI is reshaping industries, with key players like OpenAI, Anthropic, and Google DeepMind...
2. **AI Trends: What's Coming Next?**
URL: https://techcrunch.com/ai-trends-2024
This year we’ll see more foundation model APIs, compliance tooling, and multi-modal agents...
```
---
For questions or API access, visit [linkup.so](https://linkup.so).
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|