| --- |
| 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) |
|
|
