Skip to main content
Visual workflow builder allows you to create, connect, and manage agentic processes using a drag-and-drop interface.

Quick Start

1

Install Flow Addon

Install the visual builder components.
pip install "praisonai[flow]"
2

Launch Visual Builder

Start the local server and open the web interface.
praisonai flow
3

Connect Components

Open http://localhost:7860 to access the interface. Drag and drop Agent and Agent Team nodes to orchestrate workflows.

How It Works

ComponentPurposeAvailability
Agent NodeIndividual AI entity with tailored instructionsSidebar > PraisonAI
Agent Team NodeMulti-agent orchestrator connecting multiple nodesSidebar > PraisonAI
CLI CommandBackend server runtime wrapperpraisonai CLI

Agent Configuration Options

Options available on the Agent node visual component.
OptionTypeDefaultDescription
Agent Namestr"Agent"Name for identification and logging.
Previous AgentHandleNoneConnect from previous agent to define execution order.
RolestrNoneRole defining the agent’s expertise.
GoalstrNonePrimary objective the agent aims to achieve.
Instructionsstr"You are a helpful assistant."System prompt for the agent.
Modelstr"openai/gpt-4o-mini"LLM model to use (provider/model format).
InputHandleNoneUser input to process.
ToolsHandleNoneTools available to the agent.
MemoryboolFalseEnable context retention.
GuardrailsboolFalseEnable output validation guardrails.
Knowledge FilesFileNoneFiles to use as knowledge sources (PDF, TXT, etc.).

Agent Team Configuration Options

Options available on the Agent Team node visual component for multi-agent workflows.
OptionTypeDefaultDescription
Namestr"AgentTeam"Name for this multi-agent team.
AgentsHandle[]List of connected PraisonAI agents to orchestrate.
InputHandleNoneInitial input to start the multi-agent workflow.
Processstr"sequential"Collaboration mode (sequential, hierarchical, workflow).
Manager LLMstr"openai/gpt-4o"LLM used for auto-created managers.
Shared MemoryboolFalseEnable shared memory across all agents.
PlanningboolFalseEnable planning mode for task decomposition.
ReflectionboolFalseEnable self-reflection for improved results.

Common Patterns

Sequential Connections

Connect individual Agent nodes linearly (Agent 1 → Agent 2) by linking the Agent output handle on the first node to the Previous Agent input handle on the second node.

Multi-Agent Orchestration

Connect multiple Agent nodes directly to the Agents input handle of an Agent Team node. The team node evaluates the topology and runs the sub-agents properly.

Best Practices

When using the agent node’s knowledge capabilities, be sure to upload compatible document types (PDF, TXT, CSV) or provide valid URLs in the Knowledge inputs.
Use the Previous Agent connection to establish hard execution boundaries. The orchestrator automatically parses node inputs backwards to map deterministic execution flow.
Click the “Advanced” toggle on nodes inside Langflow to expose robust SDK parameters like custom Base URLs, Code Execution Mode, Verbose logging, and specific Memory Providers.

Agent Workflow

Understand the core concepts of workflows.

Agent Teams

Learn how to build collaborative AI teams.