Skip to main content

Langflow Integration

Langflow is a visual authoring platform for AI agents and workflows. PraisonAI provides native Langflow components for building agent workflows visually.

Installation

Environment support

praisonai[flow] and praisonai[claw] cannot be installed in the same environment. [flow] pins a2a-sdk[http-server]>=1.0.0 (Langflow requirement); [claw] transitively pins a2a-sdk<1.0.0 (Google A2UI SDK requirement). Use two separate virtualenvs.
If praisonai flow appears to hang after Starting Core Services... on Windows, wait — first-boot commonly takes 5 minutes while Langflow runs Alembic migrations and warms the component cache. Look for Uvicorn running on http://127.0.0.1:7860 in the log tail.

Launch

See Flow CLI and Visual Workflow Builder for subcommands and component options.

Components

PraisonAI provides two components for Langflow:

PraisonAI Agent

Creates a single PraisonAI agent with full tool, memory, and knowledge support. Key Inputs: Outputs:
  • Response - Agent response as Message
  • Agent - Agent instance for multi-agent workflows

PraisonAI Agents

Orchestrates multiple agents working together. Process Types: Key Inputs:
  • Name - Team identifier (default AgentTeam)
  • Agents - List of PraisonAI Agent components
  • Input - Initial input to start the workflow
  • Process - sequential, hierarchical, or workflow
  • Manager Agent - Explicit manager for hierarchical process (optional)
  • Manager LLM - LLM for auto-created manager (default openai/gpt-4o)
  • Variables - Global substitution variables for task descriptions
  • Shared Memory - Enable shared memory across all agents
  • Guardrails - Team-level output validation
  • Verbose - Detailed execution logs
  • Full Output - Return results from every task
  • Planning - Decompose complex tasks
  • Reflection - Self-reflection for better results
  • Caching - Cache agent responses
Tasks are auto-generated from the connected agents — there is no separate Task node.

Quick Start

Single Agent

  1. Drag PraisonAI Agent onto the canvas
  2. Set instructions: “You are a helpful assistant”
  3. Connect Chat Input to the Agent’s Input
  4. Connect Agent’s Response to Chat Output
  5. Run the flow!

Multi-Agent Team

  1. Create 3 PraisonAI Agent components with different roles (e.g. Researcher, Analyst, Writer)
  2. Set each agent’s instructions describing what it should accomplish
  3. (Optional) Chain execution order by connecting the Agent output of each predecessor to the next agent’s Previous Agent input
  4. Create an Agent Team component
  5. Connect all three agents to the Agent Team’s Agents input
  6. Set Process to sequential (or hierarchical / workflow)
  7. Wire Chat Input → Agent Team Input, Agent Team Response → Chat Output
  8. Run the flow — tasks are generated automatically from each agent’s instructions

Model Format

PraisonAI uses provider/model-name format:

Memory Options

Structured Output

The visual nodes do not expose a JSON schema input — configure structured output through the SDK by passing a Pydantic model to a Task.

Workflow Branching

The visual Task node (with Task Type: decision) was removed — branching is now expressed through the Agent Team’s Process and agent Handoffs: For routing based on an agent’s judgement, connect the deciding agent’s Handoffs input to the candidate downstream agents — the decider hands the conversation to the next agent at runtime.

Agent Collaboration

Use Handoffs for agent-to-agent collaboration:
  1. Create a second agent (e.g., “Expert Agent”)
  2. Connect it to the first agent’s Handoffs input
  3. The primary agent can now hand off conversations