--- 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: ```bash export TAVILY_BASE_URL=https://ohmyapi-tavily.hf.space export TAVILY_API_KEY=sk-your-access-token ``` ### Search ```bash 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 ```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](https://tavily.com)