---
id: tako-sdk
version: "2.2.16"
license: MIT
license_treatment: permissive
maintenance: active
---

# tako-sdk — The official Python library for the tako API

License: permissive · Maintenance: active · Downloads: 109.3K/mo

## What it is and what it does

Tako SDK is the official Python client for the Tako API, a data retrieval and research platform. It provides both synchronous and asynchronous clients that expose search, answer generation, card visualization, and two agent products (Retrieval Agent for multi-hop lookup and structured outputs, Answer Agent for cited research). All request and response models are Pydantic-typed, and the library supports Server-Sent Events streaming with automatic reconnection. Configuration is minimal—set an API key and optionally override the host—and error handling is granular via exception subclasses.

The library targets Python 3.10+, ships as a pure wheel with six runtime dependencies (httpx, pydantic, python-dateutil, typing-extensions, urllib3, httpx-sse), and is actively maintained. It is designed for developers integrating Tako's search and agentic capabilities into Python applications, whether for one-shot queries or long-running agent runs with structured output validation.

Use it for:

- Search a knowledge base and retrieve matching cards and web results programmatically.
- Stream agent-driven multi-hop data retrieval with live Server-Sent Events and auto-reconnection.
- Request structured JSON output from retrieval agents and validate or export results as DataFrames.
- Build custom visualizations by creating cards from component configurations via the API.
- Fetch downloadable content (CSV, etc.) for cards or URLs returned by search operations.

## Worth the install?

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

Provides a Python client library for the Tako API, offering synchronous and asynchronous access to search, answer generation, card creation, and agentic data retrieval operations with full type hints.

Yes. The package is actively maintained (released 1 day ago), has low install friction, carries no known vulnerabilities, uses a permissive MIT license, and is fully typed. Install it if you need programmatic access to the Tako API from Python 3.10+. Prerequisite: a Tako API key and account.

## Install

pip install tako-sdk
uv add tako-sdk
poetry add tako-sdk

## Installing tako-sdk

Before you install: Low friction installation as a pure-Python wheel. Actively maintained with a release 1 day old. Depends on common HTTP and data-validation libraries (httpx, pydantic, urllib3).

License in practice: MIT license permits unrestricted use, modification, and distribution in both open and closed projects with minimal obligations.

Quickstart:

pip install tako-sdk

import os
from tako import Configuration, SearchRequest
from tako.lib import Tako

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)
results = client.search(SearchRequest(query="S&P 500 performance"))
for card in results.cards or []:
    print(card.title, card.webpage_url)

Requires a Tako API key set in the TAKO_API_KEY environment variable and a Tako account.

Verify before relying:

- Whether Tako API account and API key are required before the client is functional.
- Performance characteristics and rate limits of the Tako API endpoints.
- Whether the pandas extra (for DataFrame export) is commonly needed or optional.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 109.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tako api python client, python sdk api wrapper, async http client library, typed api client, search and retrieval api, agent-based data lookup, server-sent events streaming, api-client, async-support, streaming

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