---
id: pipecat-ai-flows
version: "1.4.0"
license: BSD 2-Clause License
license_treatment: permissive
maintenance: abandoned
---

# pipecat-ai-flows — Conversation Flow management for Pipecat AI applications

License: permissive · Maintenance: abandoned · Downloads: 142.9K/mo

## What it is and what it does

Pipecat Flows provides conversation flow and state machine management for building AI applications with Pipecat. It lets you define multi-step dialogue logic, route between conversation states, and orchestrate LLM interactions in a structured way. The package depends on pipecat-ai, loguru, and docstring_parser.

However, this package is now deprecated and frozen. As of pipecat-ai 1.5.0, Pipecat Flows has been merged into the core pipecat-ai package under the pipecat.flows namespace. The standalone pipecat-ai-flows package will receive no further updates. Existing users should migrate by installing pipecat-ai and updating imports from pipecat_flows to pipecat.flows; the API remains the same.

Use it for:

- Building multi-turn conversation systems where dialogue must branch based on user input or LLM decisions.
- Implementing state machines for complex AI agent workflows that need to track context and manage transitions.
- Orchestrating conversation flows in existing Pipecat applications that haven't yet migrated to pipecat-ai 1.5.0+.

## Worth the install?

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

Manages conversation flows and state machines for Pipecat AI applications, but this package is deprecated—Pipecat Flows is now integrated into pipecat-ai 1.5.0+ under the pipecat.flows namespace.

No. This package is deprecated and archived. Install pipecat-ai 1.5.0+ instead, which includes Pipecat Flows under pipecat.flows with the same API. If you are maintaining legacy code using pipecat-ai-flows 1.4.0, plan a migration to the integrated version; do not start new projects with this package.

## Install

pip install pipecat-ai-flows
uv add pipecat-ai-flows
poetry add pipecat-ai-flows

## Installing pipecat-ai-flows

Before you install: Low install friction, but maintenance is abandoned: the repository is archived and the package is frozen. The last release was 40 days ago. All active development has moved into pipecat-ai itself, making this package a legacy artifact.

License in practice: BSD 2-Clause License (permissive) poses no restriction on use or redistribution, but the abandoned status means no future license updates or clarifications will arrive.

Quickstart:

# Deprecated: use pipecat-ai 1.5.0+ instead
pip install pipecat-ai

from pipecat.flows import FlowManager, NodeConfig
flow = FlowManager()

Requires Python 3.11 or later. This package is deprecated; new code should use pipecat.flows from pipecat-ai 1.5.0+ instead.

Verify before relying:

- Whether existing code using pipecat-ai-flows 1.4.0 will continue to work without updates or if pipecat-ai 1.5.0+ introduces breaking changes.
- Whether the pipecat.flows API in pipecat-ai 1.5.0+ is truly identical or if subtle behavioral differences exist.

## Package facts

- License: BSD 2-Clause License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 142.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

conversation flow management, state machine for ai, pipecat flows, llm conversation routing, ai dialogue orchestration, deprecated, archived, state-machine

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