Metadata-Version: 2.4
Name: airbyte-agent-sdk
Version: 0.1.95
Summary: Airbyte Agent SDK: typed connectors that give AI agents access to 50+ third-party APIs
Author-email: Airbyte <contact@airbyte.io>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: jinja2>=3.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: segment-analytics-python>=2.2.0
Requires-Dist: jsonref>=1.1.0
Requires-Dist: jsonpath-ng>=1.6.1
Requires-Dist: opentelemetry-api>=1.37.0
Requires-Dist: opentelemetry-sdk>=1.37.0
Requires-Dist: jsonschema>=4.0.0
Requires-Dist: packaging>=21.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio<1.0.0,>=0.21.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
Requires-Dist: pytest-httpx>=0.30.0; extra == "dev"
Requires-Dist: ruff==0.7.3; extra == "dev"
Requires-Dist: pdoc>=15.0.0; extra == "dev"
Requires-Dist: poethepoet>=0.24.0; extra == "dev"
Requires-Dist: pydantic-ai>=0.0.14; extra == "dev"
Dynamic: license-file

# Airbyte Agent SDK

Type-safe connector execution framework with blessed connectors and full IDE autocomplete.

## Overview

The Airbyte Agent SDK gives AI agents access to 50+ third-party APIs through strongly typed, well-documented tools. Connectors can run through the Airbyte platform (which manages credentials, rate limiting, and execution) or locally in OSS mode.

## How to install

```bash
uv pip install airbyte-agent-sdk
```

## CLI Quickstart

The `airbyte-agent-sdk` console script ships seven subcommands:

```bash
uv run airbyte-agent-sdk --help
```

```bash
uv run airbyte-agent-sdk annotate --help
```

```bash
uv run airbyte-agent-sdk cassette --help
```

```bash
uv run airbyte-agent-sdk connector --help
```

```bash
uv run airbyte-agent-sdk generate-docs --help
```

```bash
uv run airbyte-agent-sdk generate-sdk --help
```

```bash
uv run airbyte-agent-sdk test --help
```

```bash
uv run airbyte-agent-sdk validate --help
```

## Documentation

Full documentation is available at [docs.airbyte.com/ai-agents/about/](https://docs.airbyte.com/ai-agents/about/).

## How to install the skills

The repo ships skills that walk agents through setting up and using the connectors. Three install paths:

**skills.sh** (works for Claude Code, Codex, Cursor, OpenCode, and 40+ other agents):

```bash
npx skills add airbytehq/airbyte-agent-sdk
```

**Claude Code** (native plugin):

```
/plugin marketplace add airbytehq/airbyte-agent-sdk
/plugin install airbyte-agent-sdk@airbyte-agent-sdk
```

**Codex** (clone + symlink):

```bash
git clone https://github.com/airbytehq/airbyte-agent-sdk ~/.codex/skills/airbyte-agent-sdk-src
ln -s ~/.codex/skills/airbyte-agent-sdk-src/connector-sdk/.claude/skills/* ~/.codex/skills/
```

See [docs.airbyte.com/ai-agents/about/](https://docs.airbyte.com/ai-agents/about/) for full documentation.
