praisonAI 2.3.32__tar.gz → 2.3.34__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. {praisonai-2.3.32 → praisonai-2.3.34}/PKG-INFO +74 -2
  2. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/PKG-INFO +74 -2
  3. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/SOURCES.txt +2 -0
  4. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/requires.txt +1 -1
  5. {praisonai-2.3.32 → praisonai-2.3.34}/README.md +72 -0
  6. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/agents_generator.py +4 -3
  7. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/__init__.py +5 -0
  8. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/flow_display.py +51 -4
  9. praisonai-2.3.34/praisonai/cli/features/n8n.py +670 -0
  10. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/main.py +189 -1
  11. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/deploy.py +1 -1
  12. praisonai-2.3.34/praisonai/version.py +1 -0
  13. {praisonai-2.3.32 → praisonai-2.3.34}/pyproject.toml +1 -1
  14. praisonai-2.3.34/tests/test_n8n_integration.py +246 -0
  15. praisonai-2.3.32/praisonai/version.py +0 -1
  16. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/dependency_links.txt +0 -0
  17. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/entry_points.txt +0 -0
  18. {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/top_level.txt +0 -0
  19. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/__init__.py +0 -0
  20. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/__main__.py +0 -0
  21. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/api/call.py +0 -0
  22. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/auto.py +0 -0
  23. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/chainlit_ui.py +0 -0
  24. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/__init__.py +0 -0
  25. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/auto_memory.py +0 -0
  26. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/base.py +0 -0
  27. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/fast_context.py +0 -0
  28. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/guardrail.py +0 -0
  29. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/handoff.py +0 -0
  30. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/image.py +0 -0
  31. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/knowledge.py +0 -0
  32. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/mcp.py +0 -0
  33. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/metrics.py +0 -0
  34. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/router.py +0 -0
  35. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/session.py +0 -0
  36. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/telemetry.py +0 -0
  37. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/todo.py +0 -0
  38. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/tools.py +0 -0
  39. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/workflow.py +0 -0
  40. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inbuilt_tools/__init__.py +0 -0
  41. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inbuilt_tools/autogen_tools.py +0 -0
  42. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/__init__.py +0 -0
  43. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/config.py +0 -0
  44. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/models.py +0 -0
  45. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/scheduler.py +0 -0
  46. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/__init__.py +0 -0
  47. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/build.py +0 -0
  48. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/post_install.py +0 -0
  49. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/setup_conda_env.py +0 -0
  50. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup.py +0 -0
  51. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/test.py +0 -0
  52. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/train.py +0 -0
  53. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/train_vision.py +0 -0
  54. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/agents.py +0 -0
  55. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/callbacks.py +0 -0
  56. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/chat.py +0 -0
  57. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/code.py +0 -0
  58. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/colab.py +0 -0
  59. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/colab_chainlit.py +0 -0
  60. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/components/aicoder.py +0 -0
  61. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/context.py +0 -0
  62. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/database_config.py +0 -0
  63. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/db.py +0 -0
  64. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtime.py +0 -0
  65. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtimeclient/__init__.py +0 -0
  66. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtimeclient/tools.py +0 -0
  67. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/sql_alchemy.py +0 -0
  68. {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/upload_vision.py +0 -0
  69. {praisonai-2.3.32 → praisonai-2.3.34}/setup.cfg +0 -0
  70. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test.py +0 -0
  71. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_agents_playbook.py +0 -0
  72. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_basic.py +0 -0
  73. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_cli_features.py +0 -0
  74. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_custom_tools_fix.py +0 -0
  75. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_double_api_fix.py +0 -0
  76. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_phase2_refactor.py +0 -0
  77. {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_runner.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: PraisonAI
3
- Version: 2.3.32
3
+ Version: 2.3.34
4
4
  Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
5
5
  Author: Mervin Praison
6
6
  License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
11
11
  Requires-Dist: rich>=13.7
12
12
  Requires-Dist: markdown>=3.5
13
13
  Requires-Dist: pyparsing>=3.0.0
14
- Requires-Dist: praisonaiagents>=0.1.10
14
+ Requires-Dist: praisonaiagents>=0.1.14
15
15
  Requires-Dist: python-dotenv>=0.19.0
16
16
  Requires-Dist: instructor>=1.3.3
17
17
  Requires-Dist: PyYAML>=6.0
@@ -131,6 +131,7 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
131
131
 
132
132
  ## 📑 Table of Contents
133
133
 
134
+ - [⚡ Performance](#-performance)
134
135
  - [🚀 Quick Start](#-quick-start)
135
136
  - [📦 Installation](#-installation)
136
137
  - [Python SDK](#python-sdk)
@@ -170,6 +171,32 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
170
171
 
171
172
  ---
172
173
 
174
+ ## ⚡ Performance
175
+
176
+ PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
177
+
178
+ | Framework | Avg Time (μs) | Relative |
179
+ |-----------|---------------|----------|
180
+ | **PraisonAI** | **3.77** | **1.00x (fastest)** |
181
+ | OpenAI Agents SDK | 5.26 | 1.39x |
182
+ | Agno | 5.64 | 1.49x |
183
+ | PraisonAI (LiteLLM) | 7.56 | 2.00x |
184
+ | PydanticAI | 226.94 | 60.16x |
185
+ | LangGraph | 4,558.71 | 1,209x |
186
+ | CrewAI | 15,607.92 | 4,138x |
187
+
188
+ <details>
189
+ <summary>Run benchmarks yourself</summary>
190
+
191
+ ```bash
192
+ cd praisonai-agents
193
+ python benchmarks/simple_benchmark.py
194
+ ```
195
+
196
+ </details>
197
+
198
+ ---
199
+
173
200
  ## 🚀 Quick Start
174
201
 
175
202
  Get started with PraisonAI in under 1 minute:
@@ -1489,6 +1516,36 @@ praisonai commit
1489
1516
  praisonai commit --push
1490
1517
  ```
1491
1518
 
1519
+ ### Serve CLI (API Server):
1520
+ ```bash
1521
+ # Start API server for agents defined in YAML
1522
+ praisonai serve agents.yaml
1523
+
1524
+ # With custom port and host
1525
+ praisonai serve agents.yaml --port 8005 --host 0.0.0.0
1526
+
1527
+ # Alternative flag style
1528
+ praisonai agents.yaml --serve
1529
+
1530
+ # The server provides:
1531
+ # POST /agents - Run all agents sequentially
1532
+ # POST /agents/{name} - Run specific agent (e.g., /agents/researcher)
1533
+ # GET /agents/list - List available agents
1534
+ ```
1535
+
1536
+ ### n8n Integration CLI:
1537
+ ```bash
1538
+ # Export workflow to n8n and open in browser
1539
+ praisonai agents.yaml --n8n
1540
+
1541
+ # With custom n8n URL
1542
+ praisonai agents.yaml --n8n --n8n-url http://localhost:5678
1543
+
1544
+ # Set N8N_API_KEY for auto-import
1545
+ export N8N_API_KEY="your-api-key"
1546
+ praisonai agents.yaml --n8n
1547
+ ```
1548
+
1492
1549
  ### @Mentions in Prompts:
1493
1550
  ```bash
1494
1551
  # Include file content in prompt
@@ -1620,6 +1677,21 @@ agent = Agent(
1620
1677
  env={"BRAVE_API_KEY": "your-key"}
1621
1678
  )
1622
1679
  )
1680
+
1681
+ # Multiple MCP servers + regular functions
1682
+ def my_custom_tool(query: str) -> str:
1683
+ """Custom tool function."""
1684
+ return f"Result: {query}"
1685
+
1686
+ agent = Agent(
1687
+ name="MultiToolAgent",
1688
+ instructions="Agent with multiple MCP servers",
1689
+ tools=[
1690
+ MCP("uvx mcp-server-time"), # Time tools
1691
+ MCP("npx @modelcontextprotocol/server-memory"), # Memory tools
1692
+ my_custom_tool # Regular function
1693
+ ]
1694
+ )
1623
1695
  ```
1624
1696
 
1625
1697
  ### MCP Server (Expose Tools as MCP Server)
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: PraisonAI
3
- Version: 2.3.32
3
+ Version: 2.3.34
4
4
  Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
5
5
  Author: Mervin Praison
6
6
  License: MIT
@@ -11,7 +11,7 @@ Description-Content-Type: text/markdown
11
11
  Requires-Dist: rich>=13.7
12
12
  Requires-Dist: markdown>=3.5
13
13
  Requires-Dist: pyparsing>=3.0.0
14
- Requires-Dist: praisonaiagents>=0.1.10
14
+ Requires-Dist: praisonaiagents>=0.1.14
15
15
  Requires-Dist: python-dotenv>=0.19.0
16
16
  Requires-Dist: instructor>=1.3.3
17
17
  Requires-Dist: PyYAML>=6.0
@@ -131,6 +131,7 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
131
131
 
132
132
  ## 📑 Table of Contents
133
133
 
134
+ - [⚡ Performance](#-performance)
134
135
  - [🚀 Quick Start](#-quick-start)
135
136
  - [📦 Installation](#-installation)
136
137
  - [Python SDK](#python-sdk)
@@ -170,6 +171,32 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
170
171
 
171
172
  ---
172
173
 
174
+ ## ⚡ Performance
175
+
176
+ PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
177
+
178
+ | Framework | Avg Time (μs) | Relative |
179
+ |-----------|---------------|----------|
180
+ | **PraisonAI** | **3.77** | **1.00x (fastest)** |
181
+ | OpenAI Agents SDK | 5.26 | 1.39x |
182
+ | Agno | 5.64 | 1.49x |
183
+ | PraisonAI (LiteLLM) | 7.56 | 2.00x |
184
+ | PydanticAI | 226.94 | 60.16x |
185
+ | LangGraph | 4,558.71 | 1,209x |
186
+ | CrewAI | 15,607.92 | 4,138x |
187
+
188
+ <details>
189
+ <summary>Run benchmarks yourself</summary>
190
+
191
+ ```bash
192
+ cd praisonai-agents
193
+ python benchmarks/simple_benchmark.py
194
+ ```
195
+
196
+ </details>
197
+
198
+ ---
199
+
173
200
  ## 🚀 Quick Start
174
201
 
175
202
  Get started with PraisonAI in under 1 minute:
@@ -1489,6 +1516,36 @@ praisonai commit
1489
1516
  praisonai commit --push
1490
1517
  ```
1491
1518
 
1519
+ ### Serve CLI (API Server):
1520
+ ```bash
1521
+ # Start API server for agents defined in YAML
1522
+ praisonai serve agents.yaml
1523
+
1524
+ # With custom port and host
1525
+ praisonai serve agents.yaml --port 8005 --host 0.0.0.0
1526
+
1527
+ # Alternative flag style
1528
+ praisonai agents.yaml --serve
1529
+
1530
+ # The server provides:
1531
+ # POST /agents - Run all agents sequentially
1532
+ # POST /agents/{name} - Run specific agent (e.g., /agents/researcher)
1533
+ # GET /agents/list - List available agents
1534
+ ```
1535
+
1536
+ ### n8n Integration CLI:
1537
+ ```bash
1538
+ # Export workflow to n8n and open in browser
1539
+ praisonai agents.yaml --n8n
1540
+
1541
+ # With custom n8n URL
1542
+ praisonai agents.yaml --n8n --n8n-url http://localhost:5678
1543
+
1544
+ # Set N8N_API_KEY for auto-import
1545
+ export N8N_API_KEY="your-api-key"
1546
+ praisonai agents.yaml --n8n
1547
+ ```
1548
+
1492
1549
  ### @Mentions in Prompts:
1493
1550
  ```bash
1494
1551
  # Include file content in prompt
@@ -1620,6 +1677,21 @@ agent = Agent(
1620
1677
  env={"BRAVE_API_KEY": "your-key"}
1621
1678
  )
1622
1679
  )
1680
+
1681
+ # Multiple MCP servers + regular functions
1682
+ def my_custom_tool(query: str) -> str:
1683
+ """Custom tool function."""
1684
+ return f"Result: {query}"
1685
+
1686
+ agent = Agent(
1687
+ name="MultiToolAgent",
1688
+ instructions="Agent with multiple MCP servers",
1689
+ tools=[
1690
+ MCP("uvx mcp-server-time"), # Time tools
1691
+ MCP("npx @modelcontextprotocol/server-memory"), # Memory tools
1692
+ my_custom_tool # Regular function
1693
+ ]
1694
+ )
1623
1695
  ```
1624
1696
 
1625
1697
  ### MCP Server (Expose Tools as MCP Server)
@@ -33,6 +33,7 @@ praisonai/cli/features/image.py
33
33
  praisonai/cli/features/knowledge.py
34
34
  praisonai/cli/features/mcp.py
35
35
  praisonai/cli/features/metrics.py
36
+ praisonai/cli/features/n8n.py
36
37
  praisonai/cli/features/router.py
37
38
  praisonai/cli/features/session.py
38
39
  praisonai/cli/features/telemetry.py
@@ -68,5 +69,6 @@ tests/test_basic.py
68
69
  tests/test_cli_features.py
69
70
  tests/test_custom_tools_fix.py
70
71
  tests/test_double_api_fix.py
72
+ tests/test_n8n_integration.py
71
73
  tests/test_phase2_refactor.py
72
74
  tests/test_runner.py
@@ -1,7 +1,7 @@
1
1
  rich>=13.7
2
2
  markdown>=3.5
3
3
  pyparsing>=3.0.0
4
- praisonaiagents>=0.1.10
4
+ praisonaiagents>=0.1.14
5
5
  python-dotenv>=0.19.0
6
6
  instructor>=1.3.3
7
7
  PyYAML>=6.0
@@ -34,6 +34,7 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
34
34
 
35
35
  ## 📑 Table of Contents
36
36
 
37
+ - [⚡ Performance](#-performance)
37
38
  - [🚀 Quick Start](#-quick-start)
38
39
  - [📦 Installation](#-installation)
39
40
  - [Python SDK](#python-sdk)
@@ -73,6 +74,32 @@ PraisonAI is a production-ready Multi-AI Agents framework with self-reflection,
73
74
 
74
75
  ---
75
76
 
77
+ ## ⚡ Performance
78
+
79
+ PraisonAI Agents is the **fastest AI agent framework** for agent instantiation.
80
+
81
+ | Framework | Avg Time (μs) | Relative |
82
+ |-----------|---------------|----------|
83
+ | **PraisonAI** | **3.77** | **1.00x (fastest)** |
84
+ | OpenAI Agents SDK | 5.26 | 1.39x |
85
+ | Agno | 5.64 | 1.49x |
86
+ | PraisonAI (LiteLLM) | 7.56 | 2.00x |
87
+ | PydanticAI | 226.94 | 60.16x |
88
+ | LangGraph | 4,558.71 | 1,209x |
89
+ | CrewAI | 15,607.92 | 4,138x |
90
+
91
+ <details>
92
+ <summary>Run benchmarks yourself</summary>
93
+
94
+ ```bash
95
+ cd praisonai-agents
96
+ python benchmarks/simple_benchmark.py
97
+ ```
98
+
99
+ </details>
100
+
101
+ ---
102
+
76
103
  ## 🚀 Quick Start
77
104
 
78
105
  Get started with PraisonAI in under 1 minute:
@@ -1392,6 +1419,36 @@ praisonai commit
1392
1419
  praisonai commit --push
1393
1420
  ```
1394
1421
 
1422
+ ### Serve CLI (API Server):
1423
+ ```bash
1424
+ # Start API server for agents defined in YAML
1425
+ praisonai serve agents.yaml
1426
+
1427
+ # With custom port and host
1428
+ praisonai serve agents.yaml --port 8005 --host 0.0.0.0
1429
+
1430
+ # Alternative flag style
1431
+ praisonai agents.yaml --serve
1432
+
1433
+ # The server provides:
1434
+ # POST /agents - Run all agents sequentially
1435
+ # POST /agents/{name} - Run specific agent (e.g., /agents/researcher)
1436
+ # GET /agents/list - List available agents
1437
+ ```
1438
+
1439
+ ### n8n Integration CLI:
1440
+ ```bash
1441
+ # Export workflow to n8n and open in browser
1442
+ praisonai agents.yaml --n8n
1443
+
1444
+ # With custom n8n URL
1445
+ praisonai agents.yaml --n8n --n8n-url http://localhost:5678
1446
+
1447
+ # Set N8N_API_KEY for auto-import
1448
+ export N8N_API_KEY="your-api-key"
1449
+ praisonai agents.yaml --n8n
1450
+ ```
1451
+
1395
1452
  ### @Mentions in Prompts:
1396
1453
  ```bash
1397
1454
  # Include file content in prompt
@@ -1523,6 +1580,21 @@ agent = Agent(
1523
1580
  env={"BRAVE_API_KEY": "your-key"}
1524
1581
  )
1525
1582
  )
1583
+
1584
+ # Multiple MCP servers + regular functions
1585
+ def my_custom_tool(query: str) -> str:
1586
+ """Custom tool function."""
1587
+ return f"Result: {query}"
1588
+
1589
+ agent = Agent(
1590
+ name="MultiToolAgent",
1591
+ instructions="Agent with multiple MCP servers",
1592
+ tools=[
1593
+ MCP("uvx mcp-server-time"), # Time tools
1594
+ MCP("npx @modelcontextprotocol/server-memory"), # Memory tools
1595
+ my_custom_tool # Regular function
1596
+ ]
1597
+ )
1526
1598
  ```
1527
1599
 
1528
1600
  ### MCP Server (Expose Tools as MCP Server)
@@ -327,7 +327,8 @@ class AgentsGenerator:
327
327
  # Route to YAMLWorkflowParser for advanced workflow patterns
328
328
  return self._run_yaml_workflow(config)
329
329
 
330
- topic = config.get('topic', '')
330
+ # Get workflow input: 'input' is canonical, 'topic' is alias for backward compatibility
331
+ topic = config.get('input', config.get('topic', ''))
331
332
  tools_dict = {}
332
333
 
333
334
  # Only try to use praisonai_tools if it's available and needed
@@ -459,8 +460,8 @@ class AgentsGenerator:
459
460
  parser = YAMLWorkflowParser()
460
461
  workflow = parser.parse_string(yaml_content)
461
462
 
462
- # Get input from topic or variables
463
- input_data = config.get('topic', '')
463
+ # Get input: 'input' is canonical, 'topic' is alias for backward compatibility
464
+ input_data = config.get('input', config.get('topic', ''))
464
465
 
465
466
  # Execute workflow
466
467
  self.logger.debug(f"Running workflow: {workflow.name}")
@@ -20,6 +20,7 @@ Features:
20
20
  - router: Smart model selection
21
21
  - flow_display: Visual workflow tracking
22
22
  - workflow: YAML workflow management
23
+ - n8n: Export workflows to n8n visual editor
23
24
  """
24
25
 
25
26
  # Type hints available for IDE support
@@ -41,6 +42,7 @@ __all__ = [
41
42
  'RouterHandler',
42
43
  'FlowDisplayHandler',
43
44
  'WorkflowHandler',
45
+ 'N8nHandler',
44
46
  ]
45
47
 
46
48
  def __getattr__(name):
@@ -90,4 +92,7 @@ def __getattr__(name):
90
92
  elif name == 'WorkflowHandler':
91
93
  from .workflow import WorkflowHandler
92
94
  return WorkflowHandler
95
+ elif name == 'N8nHandler':
96
+ from .n8n import N8nHandler
97
+ return N8nHandler
93
98
  raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
@@ -154,10 +154,10 @@ class FlowDisplayHandler(FlagHandler):
154
154
  if description:
155
155
  info_table.add_row("📝 Description:", description)
156
156
 
157
- # Show topic/input if present
158
- topic = config.get('topic', '')
159
- if topic:
160
- info_table.add_row("💬 Input:", topic)
157
+ # Show input if present ('input' is canonical, 'topic' is alias)
158
+ workflow_input = config.get('input', config.get('topic', ''))
159
+ if workflow_input:
160
+ info_table.add_row("💬 Input:", workflow_input)
161
161
 
162
162
  info_table.add_row("⚙️ Framework:", framework)
163
163
 
@@ -504,6 +504,53 @@ class FlowDisplayHandler(FlagHandler):
504
504
 
505
505
  console.print(table)
506
506
 
507
+ def display_workflow_start(self, workflow_name: str, agents: list) -> None:
508
+ """
509
+ Display workflow start message.
510
+
511
+ Args:
512
+ workflow_name: Name of the workflow being started
513
+ agents: List of agent names in the workflow
514
+ """
515
+ console = self._get_console()
516
+ if console:
517
+ try:
518
+ from rich.panel import Panel
519
+ from rich import box
520
+
521
+ agents_str = ", ".join(agents) if agents else "No agents"
522
+ content = f"🚀 Starting: {workflow_name}\n👥 Agents: {agents_str}"
523
+ console.print(Panel(content, title="[bold cyan]Workflow Started[/bold cyan]",
524
+ border_style="cyan", box=box.ROUNDED))
525
+ except ImportError:
526
+ print(f"Starting workflow: {workflow_name} with agents: {agents}")
527
+
528
+ def display_workflow_end(self, success: bool = True) -> None:
529
+ """
530
+ Display workflow end message.
531
+
532
+ Args:
533
+ success: Whether the workflow completed successfully
534
+ """
535
+ console = self._get_console()
536
+ if console:
537
+ try:
538
+ from rich.panel import Panel
539
+ from rich import box
540
+
541
+ if success:
542
+ content = "✅ Workflow completed successfully"
543
+ style = "green"
544
+ else:
545
+ content = "❌ Workflow failed"
546
+ style = "red"
547
+
548
+ console.print(Panel(content, title=f"[bold {style}]Workflow Ended[/bold {style}]",
549
+ border_style=style, box=box.ROUNDED))
550
+ except ImportError:
551
+ status = "successfully" if success else "with errors"
552
+ print(f"Workflow ended {status}")
553
+
507
554
  def execute(self, yaml_file: str = None, **kwargs) -> bool:
508
555
  """
509
556
  Execute flow display - shows diagram without running workflow.