{"id":28437,"library":"valyu","title":"Valyu","description":"Valyu is a Python client for the Valyu Deepsearch API, enabling AI agents to perform deep searches and retrieve structured results. Current version 2.9.7, actively maintained with frequent releases.","status":"active","version":"2.9.7","language":"python","source_language":"en","source_url":"https://github.com/valyu-ai/valyu-python","tags":["deepsearch","api-client","ai","search"],"install":[{"cmd":"pip install valyu","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false}],"imports":[{"note":"The class is named Client, not ValyuClient.","wrong":"from valyu import ValyuClient","symbol":"ValyuClient","correct":"from valyu import Client"}],"quickstart":{"code":"from valyu import Client\n\nclient = Client(api_key=os.environ.get('VALYU_API_KEY', ''))\nresults = client.search(\"What is the capital of France?\")\nprint(results)","lang":"python","description":"Initialize the client with an API key and perform a search."},"warnings":[{"fix":"Use named argument `api_key` or set the VALYU_API_KEY environment variable.","message":"API key must be passed as 'api_key' parameter, not as positional argument or environment variable named 'API_KEY'.","severity":"gotcha","affected_versions":"all"},{"fix":"Access results via `response['results']` instead of iterating over the response directly.","message":"In version 2.x, the method `search` returns a dict with key 'results' instead of a list directly as in 1.x.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Replace `client.deep_search(query)` with `client.search(query)`.","message":"The `deep_search` method was deprecated in 2.9.0; use `search` instead.","severity":"deprecated","affected_versions":">=2.9.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Change to `from valyu import Client`.","cause":"Wrong import name. The class is named 'Client'.","error":"ImportError: cannot import name 'ValyuClient' from 'valyu'"},{"fix":"Use `response['results']` instead of `response.results`.","cause":"Using dot notation on the response dict. The 'search' method returns a dict, not an object.","error":"AttributeError: 'dict' object has no attribute 'results'"},{"fix":"Either set `VALYU_API_KEY` environment variable or pass `api_key` argument: `Client(api_key='your-key')`.","cause":"Not providing the API key as a named parameter or environment variable.","error":"TypeError: __init__() missing 1 required positional argument: 'api_key'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}