youdotcom

library2.3.0pypypiunverified

The official Python SDK for You.com, providing access to You.com's AI chat, code generation, and search APIs. Current version 2.3.0, requires Python >=3.10. Follows monthly release cadence.

llm-agents ai-ml http-networking

pip install youdotcom

package ↗homepage ↗

INSTALL

IMPORT

SIG · YOUDOTCOM

youdotcom

llm-agentspythonv2.3.0

Install

3.8s avg

Import

—

Disk

31MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 32.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.8s · import 0.000s · 32MB

31MB installed

● package 31MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

YouClient

✓ from youdotcom import YouClient

✗ from youdotcom import YouClient

Initialize the client with an API key and make a simple chat request.

import os from youdotcom import YouClient client = YouClient(api_key=os.environ.get('YOU_API_KEY', '')) response = client.chat.completions.create( model='gpt-4', messages=[{'role': 'user', 'content': 'Hello, how are you?'}] ) print(response.choices[0].message.content)

Debug

Known issues

breakingIn v2.0, the SDK dropped support for Python 3.9 and below. Upgrade to Python >=3.10.

fix

Require Python 3.10+ and upgrade youdotcom to latest.

affects: <=2.0.0

breakingImport paths changed in v2.0. YouClient and models are now directly under `youdotcom`, not `youdotcom.api` or `youdotcom.models`.

fix

Use `from youdotcom import YouClient, ChatCompletion` instead of old submodule imports.

affects: >=2.0.0

deprecatedThe method `youclient.chat.completions.create` now requires explicit `model` parameter; default model is deprecated and will be removed.

fix

Always specify a model string, e.g., `model='gpt-4'`.

affects: >=2.2.0

gotchaAPI key must be set via environment variable `YOU_API_KEY` or passed directly. SDK does not read from .env automatically.

fix

Use `YouClient(api_key='your-key')` or export `YOU_API_KEY`.

affects: all

gotchaThe SDK uses httpx internally; proxies and custom timeouts must be configured via httpx client options, not directly on YouClient.

fix

Create an httpx.AsyncClient with desired settings and pass it as `http_client` parameter to YouClient/AsyncYouClient.

affects: all

Upgrade

Version history

2.3.0latest on PyPI · released Mar 4, 2026

Audit

Dependencies

httpxrequiredHTTP client for API calls

pydanticrequiredData validation and settings management

openaioptionalCompatibility with OpenAI-style chat completions

Agent activity

55 hits · last 30 days

node

Perplexity

Resources

packagehttps://pypi.org/project/youdotcom/ ↗

homepagehttps://you.com ↗