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.
- {praisonai-2.3.32 → praisonai-2.3.34}/PKG-INFO +74 -2
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/PKG-INFO +74 -2
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/SOURCES.txt +2 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/requires.txt +1 -1
- {praisonai-2.3.32 → praisonai-2.3.34}/README.md +72 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/agents_generator.py +4 -3
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/__init__.py +5 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/flow_display.py +51 -4
- praisonai-2.3.34/praisonai/cli/features/n8n.py +670 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/main.py +189 -1
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/deploy.py +1 -1
- praisonai-2.3.34/praisonai/version.py +1 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/pyproject.toml +1 -1
- praisonai-2.3.34/tests/test_n8n_integration.py +246 -0
- praisonai-2.3.32/praisonai/version.py +0 -1
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/dependency_links.txt +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/entry_points.txt +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/PraisonAI.egg-info/top_level.txt +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/__main__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/api/call.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/auto.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/chainlit_ui.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/auto_memory.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/base.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/fast_context.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/guardrail.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/handoff.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/image.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/knowledge.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/mcp.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/metrics.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/router.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/session.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/telemetry.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/todo.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/tools.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/cli/features/workflow.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inbuilt_tools/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inbuilt_tools/autogen_tools.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/config.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/inc/models.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/scheduler.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/build.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/post_install.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup/setup_conda_env.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/setup.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/test.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/train.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/train_vision.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/agents.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/callbacks.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/chat.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/code.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/colab.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/colab_chainlit.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/components/aicoder.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/context.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/database_config.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/db.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtime.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtimeclient/__init__.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/realtimeclient/tools.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/ui/sql_alchemy.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/praisonai/upload_vision.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/setup.cfg +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_agents_playbook.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_basic.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_cli_features.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_custom_tools_fix.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_double_api_fix.py +0 -0
- {praisonai-2.3.32 → praisonai-2.3.34}/tests/test_phase2_refactor.py +0 -0
- {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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
@@ -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
|
-
|
|
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
|
|
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
|
|
158
|
-
|
|
159
|
-
if
|
|
160
|
-
info_table.add_row("💬 Input:",
|
|
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.
|