duckduckgo-search is renamed to ddgs (#2172)

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>

Author: basnijholt

docs/common-tools.md

@@ -5,7 +5,7 @@ PydanticAI ships with native tools that can be used to enhance your agent's capa
 ## DuckDuckGo Search Tool
 
 The DuckDuckGo search tool allows you to search the web for information. It is built on top of the
-[DuckDuckGo API](https://github.com/deedy5/duckduckgo_search).
+[DuckDuckGo API](https://github.com/deedy5/ddgs).
 
 ### Installation
 

docs/install.md

@@ -54,7 +54,7 @@ pip/uv-add "pydantic-ai-slim[openai]"
 * `groq` — installs `groq` [PyPI ↗](https://pypi.org/project/groq){:target="_blank"}
 * `mistral` — installs `mistralai` [PyPI ↗](https://pypi.org/project/mistralai){:target="_blank"}
 * `cohere` - installs `cohere` [PyPI ↗](https://pypi.org/project/cohere){:target="_blank"}
-* `duckduckgo` - installs `duckduckgo-search` [PyPI ↗](https://pypi.org/project/duckduckgo-search){:target="_blank"}
+* `duckduckgo` - installs `ddgs` [PyPI ↗](https://pypi.org/project/ddgs){:target="_blank"}
 * `tavily` - installs `tavily-python` [PyPI ↗](https://pypi.org/project/tavily-python){:target="_blank"}
 
 See the [models](models/index.md) documentation for information on which optional dependencies are required for each model.

docs/tools.md

@@ -732,7 +732,7 @@ If you'd like to use a tool from LangChain's [community tool library](https://py
 
 You will need to install the `langchain-community` package and any others required by the tool in question.
 
-Here is how you can use the LangChain `DuckDuckGoSearchRun` tool, which requires the `duckduckgo-search` package:
+Here is how you can use the LangChain `DuckDuckGoSearchRun` tool, which requires the `ddgs` package:
 
 ```python {test="skip"}
 from langchain_community.tools import DuckDuckGoSearchRun

pydantic_ai_slim/pydantic_ai/common_tools/duckduckgo.py

@@ -9,10 +9,13 @@
 from pydantic_ai.tools import Tool
 
 try:
-    from duckduckgo_search import DDGS
+    try:
+        from ddgs import DDGS
+    except ImportError:  # Fallback for older versions of ddgs
+        from duckduckgo_search import DDGS
 except ImportError as _import_error:
     raise ImportError(
-        'Please install `duckduckgo-search` to use the DuckDuckGo search tool, '
+        'Please install `ddgs` to use the DuckDuckGo search tool, '
         'you can use the `duckduckgo` optional group — `pip install "pydantic-ai-slim[duckduckgo]"`'
     ) from _import_error
 

pydantic_ai_slim/pyproject.toml

@@ -70,7 +70,7 @@ groq = ["groq>=0.19.0"]
 mistral = ["mistralai>=1.2.5"]
 bedrock = ["boto3>=1.37.24"]
 # Tools
-duckduckgo = ["duckduckgo-search>=7.0.0"]
+duckduckgo = ["ddgs>=9.0.0"]
 tavily = ["tavily-python>=0.5.0"]
 # CLI
 cli = ["rich>=13", "prompt-toolkit>=3", "argcomplete>=3.5.0"]
@@ -88,6 +88,7 @@ dev = [
     "devtools>=0.12.2",
     "coverage[toml]>=7.6.2",
     "dirty-equals>=0.9.0",
+    "duckduckgo-search>=7.0.0",
     "inline-snapshot>=0.19.3",
     "pytest>=8.3.3",
     "pytest-examples>=0.0.14",