Metadata-Version: 2.4
Name: verbiflow
Version: 0.2.31
Summary: Python SDK for Verbiflow Growth workflows
Author: Verbiflow
License: MIT
Project-URL: Homepage, https://verbiflow.com
Project-URL: Documentation, https://verbiflow.com/docs
Project-URL: Agent install, https://verbiflow.com/install.md
Project-URL: Y Combinator, https://www.ycombinator.com/companies/verbiflow
Requires-Python: <3.15,>=3.14
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3,>=2.12
Requires-Dist: typing-extensions<5,>=4.14.1
Requires-Dist: httpx<1,>=0.27
Requires-Dist: opentelemetry-api<2.0.0,>=1.40.0
Provides-Extra: agents
Requires-Dist: claude-agent-sdk<0.3,>=0.2.87; extra == "agents"
Requires-Dist: openai-agents<1,>=0.17; extra == "agents"
Provides-Extra: dev
Requires-Dist: jsonschema<5,>=4.23; extra == "dev"
Requires-Dist: opentelemetry-sdk<2.0.0,>=1.40.0; extra == "dev"
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: pytest-asyncio<2,>=0.24; extra == "dev"
Requires-Dist: ruff<1,>=0.8; extra == "dev"
Requires-Dist: basedpyright<2,>=1.24; extra == "dev"
Provides-Extra: generator
Requires-Dist: jsonschema<5,>=4.23; extra == "generator"
Requires-Dist: ruff<1,>=0.8; extra == "generator"

# Verbiflow Python SDK

Agent-native Python client for Verbiflow Growth workflows. Requires Python 3.14.

Run checkout tests with `bun run sdk:python:test:unit` from the repository root.
Use `bun run sdk:python:install` to refresh a local installation. It rebuilds the
package and replaces an older Python environment with Python 3.14. For an ad hoc
non-editable uv consumer, use `uv sync --reinstall-package verbiflow` after deleting
SDK files; uv's timestamp cache does not reliably detect deletions. SDK tests
reject installations whose packaged files differ from the checkout.

```python
import verbiflow as vf

job = vf.rows.qualify(
    [{"email": "a@example.com", "title": "VP Engineering"}],
    rubric="Pass senior engineering and product leaders.",
)
print(job.job_id, job.artifact_id)
```

The SDK runs local row transforms in Python and sends provider/platform side
effects through the Verbiflow Bridge API.

First-class direct Bridge namespaces include `vf.session`, `vf.billing`,
`vf.senders`, `vf.sequences`, and `vf.linkedin` for the server-backed operator
paths.

The public SDK is typed-only. Use namespaces such as `vf.sources.people`,
`vf.enrichment`, `vf.sequences`, `vf.linkedin`, and `vf.files`;
there is no public `vf.tools` or MCP-shaped `growth_*` alias layer.
