metadata
title: Tavily Key Manager
emoji: 🔑
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
████████╗ █████╗ ██╗ ██╗██╗██╗ ██╗ ██╗
╚══██╔══╝██╔══██╗██║ ██║██║██║ ╚██╗ ██╔╝
██║ ███████║██║ ██║██║██║ ╚████╔╝
██║ ██╔══██║╚██╗ ██╔╝██║██║ ╚██╔╝
██║ ██║ ██║ ╚████╔╝ ██║███████╗██║
╚═╝ ╚═╝ ╚═╝ ╚═══╝ ╚═╝╚══════╝╚═╝
Tavily Search Proxy & Key Pool Manager
A managed Tavily API key pool with automatic round-robin selection, health checking, and access token quota system. Drop-in replacement for api.tavily.com.
Quick Start
Set your base URL to this Space's address:
export TAVILY_BASE_URL=https://ohmyapi-tavily.hf.space
export TAVILY_API_KEY=sk-your-access-token
Search
curl -X POST https://ohmyapi-tavily.hf.space/v1/search \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-access-token" \
-d '{"query": "latest AI news", "max_results": 5}'
Python
import requests
resp = requests.post(
"https://ohmyapi-tavily.hf.space/v1/search",
headers={"Authorization": "Bearer sk-your-access-token"},
json={"query": "hello world", "max_results": 3}
)
print(resp.json())
Features
| Feature | Description |
|---|---|
| Key Pool | Automatic round-robin key selection with health checking |
| Access Tokens | Per-user tokens with monthly quota management |
| Free Mode | Optional open access without token |
| Admin Dashboard | Manage keys, tokens, and configuration via web UI |
| Search Proxy | /v1/search and /v1/extract compatible with Tavily API |
| MCP Support | Works with Tavily MCP server for AI agents |
Environment Variables
| Variable | Required | Description |
|---|---|---|
ADMIN_PASSWORD |
Yes | Dashboard login password |
DATABASE_URL |
Yes | PostgreSQL connection string |
ADMIN_TOKEN |
No | Default admin API token (default: REDACTED_TOKEN) |
FREE_MODE |
No | Enable open access (default: false) |
Built with FastAPI + PostgreSQL · Powered by Tavily