---
id: seltz
version: "1.9.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# seltz — Seltz Python SDK for AI-powered search

License: unclear · Maintenance: active · Downloads: 106.8K/mo

## What it is and what it does

Seltz is the official Python SDK for Seltz, a web search engine designed for AI agents. It wraps gRPC and protobuf to communicate with Seltz's backend, offering two main capabilities: synchronous and asynchronous web search with result streaming, and natural-language answer generation grounded in web results with source citations.

The SDK supports multiple answer tiers (base and pro models), structured JSON output via OpenAI-style schemas, system prompt customization, and streaming responses. Both sync and async APIs are available, with context manager support for deterministic resource cleanup. The package targets Python 3.9 and above and depends only on grpcio and protobuf for transport.

Use it for:

- Build AI agents that need real-time web search results with citations for grounded reasoning.
- Generate natural-language answers to user queries with sources cited from live web content.
- Stream search results or answers to users as they arrive, rather than waiting for full completion.
- Integrate web search into async Python applications without blocking the event loop.
- Fetch structured JSON responses from web search queries using custom schemas.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Seltz is a Python SDK that provides web search and AI-powered answer generation for building search-augmented applications, with support for streaming and async operations.

Yes, if you need web search integration for AI applications and have a Seltz API key. The SDK is actively maintained, has low install friction, and offers both sync and async interfaces. However, verify the license status before use in proprietary projects, and confirm the service's production readiness and pricing model for your use case.

## Install

pip install seltz
uv add seltz
poetry add seltz

## Installing seltz

Before you install: Low install friction with a pure-Python wheel and only two runtime dependencies (grpcio and protobuf). The package is actively maintained with a recent release.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before use in proprietary or copyleft-sensitive projects.

Quickstart:

pip install seltz

from seltz import Seltz

client = Seltz(api_key="your-api-key")
response = client.search("best ai search engines", max_results=10)
for document in response.documents:
    print(f"URL: {document.url}")

Requires Python 3.9 or higher and a valid Seltz API key.

Verify before relying:

- Pricing model and rate limits for the Seltz API service.
- Data retention and privacy policy for queries sent through the SDK.
- Whether the service is production-ready or still in beta testing.
- Support for custom search filters or advanced query syntax.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 106.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

web search api python, ai search engine sdk, grounded answer generation, search with citations, streaming search results, async web search client, rag search python, web-search, grpc-client, async-first

[View on SkillFed](https://skillfed.io/packages/seltz) · [View on PyPI](https://pypi.org/project/seltz/)