feat: Add You.com API Suite to Nvidia AI-Q

deploy/.env.example

@@ -18,6 +18,7 @@ NVIDIA_API_KEY=
 
 
 # Web search (Required)
+YDC_API_KEY=
 TAVILY_API_KEY=
 
 # Paper search (Optional — choose one provider)

pyproject.toml

@@ -202,6 +202,7 @@ dev = [
     "google-scholar-paper-search",
     "tavily-web-search",
     "exa-web-search",
+    "you-com",
     "duckduckgo-news-search",
     "polymarket-prediction-market",
     "knowledge-layer[all]",
@@ -245,6 +246,7 @@ aiq-agent = { workspace = true }
 google-scholar-paper-search = { workspace = true }
 tavily-web-search = { workspace = true }
 exa-web-search = { workspace = true }
+you-com = { workspace = true }
 duckduckgo-news-search = { workspace = true }
 polymarket-prediction-market = { workspace = true }
 knowledge-layer = { workspace = true }

scripts/setup.sh

@@ -66,6 +66,7 @@ echo ""
 echo "Installing data sources..."
 "${UV_BIN}" pip install -e ./sources/tavily_web_search
 "${UV_BIN}" pip install -e ./sources/exa_web_search
+"${UV_BIN}" pip install -e ./sources/you_com
 "${UV_BIN}" pip install -e ./sources/google_scholar_paper_search
 "${UV_BIN}" pip install -e "./sources/knowledge_layer[llamaindex,foundational_rag]"
 echo "Data Sources installed"

sources/you_com/README.md

@@ -0,0 +1,59 @@
+# You.com Tools
+
+NAT-based tools for the You.com API. Requires a `YDC_API_KEY` environment variable or `api_key` config.
+Create an API key, claim your free credits, and learn more at https://you.com/docs/quickstart.
+
+## Tools
+
+### `you_web_search`
+
+Retrieves relevant search results from the web using You.com [Web Search](https://you.com/docs/api-reference/search/v1-search-post). Supports livecrawl (full page content),
+freshness filtering, safesearch, and news filtering.
+
+The [Web Search](https://you.com/docs/api-reference/search/v1-search-post) endpoint is designed to return LLM-ready web
+results based on a user’s query. Based on a classification mechanism, it can return web results and news associated with
+your query. If you need to feed an LLM with the results of a query that sounds like What are the latest geopolitical
+updates from India, then this endpoint is the right one for you.
+
+Key config:
+- `max_results` — number of results (1–100, default 10)
+- `safesearch` - `off`, `moderate`, `strict`
+- `livecrawl_mode` — `off`, `web`, `news`, `all` (default `web`)
+- `livecrawl_format` — `off`, `markdown`, `html` (default `markdown`)
+- `freshness` — `off`, `day`, `week`, `month`, `year`
+- `max_content_length` — truncate livecrawl content to reduce token usage
+- `include_news_results` — True/False whether or not you want to include results categorized as `news`
+
+### `you_research`
+
+
+[Research](https://you.com/docs/api-reference/research/v1-research) goes beyond a single web search. In response to your
+question, it runs multiple searches, reads through the sources, and synthesizes everything into a thorough, well-cited
+answer. Use it when a question is too complex for a simple lookup, and when you need a response you can actually trust
+and verify.
+
+Key config:
+- `research_effort` — `lite`, `standard` (default), `deep`, `exhaustive`
+
+### `you_finance_research`
+
+The [Finance Research API](https://you.com/docs/api-reference/finance-research/v1-finance_research) is purpose-built
+for financial questions. Like the Research API, it runs multiple searches, reads through sources, and synthesizes
+everything into a thorough, well-cited answer — but its retrieval index is optimized for financial data: earnings
+reports, SEC filings, analyst coverage, market data, and financial news. Use it when you need credible, sourced answers
+to financial questions: company fundamentals, market trends, competitive analysis, earnings summaries, or macroeconomic research.
+
+Key config:
+- `research_effort` — `deep` (default) or `exhaustive` only
+
+### `you_contents`
+
+Extracts clean page content from URLs using the You.com [Contents API](https://you.com/docs/api-reference/contents).
+Pass up to 10 URLs and receive their full content — no HTML parsing required.
+
+Key config:
+- `formats` — list of `markdown`, `html`, `metadata` (default `["markdown", "metadata"]`)
+- `crawl_timeout` — per-URL crawl timeout in seconds (1–60); increase for JavaScript-heavy pages
+
+We want to hear from you. If you hit a configuration issue or have questions, reach out to us at support@you.com.
+For enterprise or private inquiries, reach out to api@you.com.

sources/you_com/pyproject.toml

@@ -0,0 +1,38 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+[build-system]
+build-backend = "setuptools.build_meta"
+requires = ["setuptools >= 64", "setuptools-scm>=8"]
+
+[tool.setuptools]
+packages = ["you_com"]
+package-dir = {"you_com" = "src"}
+
+[project]
+name = "you-com"
+version = "1.0.0"
+description = "NAT-based You.com tools: web search, contents, research, and finance research"
+readme = "README.md"
+requires-python = ">=3.11,<3.14"
+license = {text = "Apache-2.0"}
+dependencies = [
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+    "langchain-youdotcom>=0.3.1",
+]
+
+[project.entry-points."nat.plugins"]
+you_com = "you_com.register"

sources/you_com/src/__init__.py

@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""You.com tools (web search, contents, research, finance research) for NAT."""
+
+from .register import you_contents  # noqa: F401
+from .register import you_finance_research  # noqa: F401
+from .register import you_research  # noqa: F401
+from .register import you_web_search  # noqa: F401
+
+__all__ = [
+    "you_finance_research",
+    "you_research",
+    "you_web_search",
+    "you_contents",
+]