|
|
---
|
|
|
title: Lancer Search API
|
|
|
emoji: 🔍
|
|
|
colorFrom: purple
|
|
|
colorTo: blue
|
|
|
sdk: docker
|
|
|
pinned: false
|
|
|
---
|
|
|
|
|
|
# Lancer Search API
|
|
|
|
|
|
🔍 Advanced AI-powered search API with temporal intelligence.
|
|
|
|
|
|
## Features
|
|
|
|
|
|
- **Temporal Intelligence**: Understands when you need fresh vs historical info
|
|
|
- **Multi-Stage Reranking**: Freshness + Authority scoring
|
|
|
- **Multi-Source Search**: Tavily, DuckDuckGo
|
|
|
- **LLM Synthesis**: Groq or OpenRouter
|
|
|
|
|
|
## API Endpoints
|
|
|
|
|
|
```bash
|
|
|
# Search with synthesis
|
|
|
POST /api/v1/search
|
|
|
{
|
|
|
"query": "What is the latest GPT model?",
|
|
|
"max_results": 10,
|
|
|
"freshness": "week"
|
|
|
}
|
|
|
|
|
|
# Health check
|
|
|
GET /health
|
|
|
```
|
|
|
|
|
|
## Environment Variables
|
|
|
|
|
|
Configure these in HuggingFace Space Secrets:
|
|
|
|
|
|
| Variable | Required | Description |
|
|
|
|----------|----------|-------------|
|
|
|
| `GROQ_API_KEY` | Yes* | Groq API key |
|
|
|
| `OPENROUTER_API_KEY` | Yes* | OpenRouter API key |
|
|
|
| `TAVILY_API_KEY` | Yes | Tavily search API key |
|
|
|
| `LLM_PROVIDER` | No | "groq" or "openrouter" |
|
|
|
|
|
|
*At least one LLM provider key required
|
|
|
|
|
|
## Local Development
|
|
|
|
|
|
```bash
|
|
|
pip install -e .
|
|
|
uvicorn app.main:app --reload
|
|
|
```
|
|
|
|
