Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 536add1ef9 |
@@ -1,100 +0,0 @@
|
|||||||
---
|
|
||||||
name: graph-based-node-workflow
|
|
||||||
version: 1.0.0
|
|
||||||
description: Create and execute typed node graphs for AI/robotics workflows by defining
|
|
||||||
nodes with inputs/outputs and connecting them with edges, then cooking the graph
|
|
||||||
to run the workflow.
|
|
||||||
inputs:
|
|
||||||
- bn.Graph() - the graph container for the workflow
|
|
||||||
- Node definitions (Literal, Text, LLMAgent, Concat, Output, etc.) with specified
|
|
||||||
inputs and outputs
|
|
||||||
- Edge connections mapping from_port to to_port between nodes
|
|
||||||
steps:
|
|
||||||
- 'Step 1: Initialize a bn.Graph() instance to serve as the workflow container'
|
|
||||||
- 'Step 2: Define individual nodes with their required inputs and outputs (e.g., Literal
|
|
||||||
for data, LLMAgent for inference, Concat for combining, Output for final results)'
|
|
||||||
- 'Step 3: Create edges connecting nodes by specifying source from_port and destination
|
|
||||||
to_port for each data flow'
|
|
||||||
- 'Step 4: Execute the graph by calling g.cook() to process the defined workflow and
|
|
||||||
produce results'
|
|
||||||
outputs:
|
|
||||||
- Executed workflow results stored in the graph's output nodes
|
|
||||||
- Cooked graph ready for inspection, replay, or deployment
|
|
||||||
- Potential error states if node dependencies are missing or ports don't match
|
|
||||||
tags: []
|
|
||||||
metadata:
|
|
||||||
source_repo: https://github.com/temiroff/Blacknode.git
|
|
||||||
extracted_at: ''
|
|
||||||
confidence: 0.95
|
|
||||||
---
|
|
||||||
|
|
||||||
# graph-based-node-workflow
|
|
||||||
|
|
||||||
Create and execute typed node graphs for AI/robotics workflows by defining nodes with inputs/outputs and connecting them with edges, then cooking the graph to run the workflow.
|
|
||||||
|
|
||||||
## Setup
|
|
||||||
|
|
||||||
**Dependencies:**
|
|
||||||
|
|
||||||
```text
|
|
||||||
pip install blacknode (core Python package) anthropic, openai, docker, petgraph (dependencies) Rust extensions in blacknode-core, blacknode-runtime (optional)
|
|
||||||
```
|
|
||||||
|
|
||||||
**Setup steps:**
|
|
||||||
|
|
||||||
1. Install blacknode with Python 3.11+ and required dependencies
|
|
||||||
1. Clone repository and navigate to project directory
|
|
||||||
1. Run examples/converted_text_pipeline.py to see basic graph execution
|
|
||||||
1. Modify node definitions and edges to create custom workflows
|
|
||||||
|
|
||||||
## Key Files
|
|
||||||
|
|
||||||
- `examples/converted_text_pipeline.py - basic pipeline pattern`
|
|
||||||
- `examples/hello_agent.py - LLM agent workflow pattern`
|
|
||||||
- `examples/research_pipeline.py - multi-node research workflow`
|
|
||||||
- `blacknode.py - main CLI entry point`
|
|
||||||
|
|
||||||
## Steps
|
|
||||||
|
|
||||||
1. Step 1: Initialize a bn.Graph() instance to serve as the workflow container
|
|
||||||
2. Step 2: Define individual nodes with their required inputs and outputs (e.g., Literal for data, LLMAgent for inference, Concat for combining, Output for final results)
|
|
||||||
3. Step 3: Create edges connecting nodes by specifying source from_port and destination to_port for each data flow
|
|
||||||
4. Step 4: Execute the graph by calling g.cook() to process the defined workflow and produce results
|
|
||||||
|
|
||||||
## Implementation Details
|
|
||||||
|
|
||||||
```python
|
|
||||||
g = bn.Graph()
|
|
||||||
```
|
|
||||||
|
|
||||||
```python
|
|
||||||
g._edges = [{"from": "model", "from_port": "value", "to": "agent", "to_port": "model"}]
|
|
||||||
```
|
|
||||||
|
|
||||||
```python
|
|
||||||
result = g.cook(output, "value")
|
|
||||||
```
|
|
||||||
|
|
||||||
## Inputs
|
|
||||||
|
|
||||||
- bn.Graph() - the graph container for the workflow
|
|
||||||
- Node definitions (Literal, Text, LLMAgent, Concat, Output, etc.) with specified inputs and outputs
|
|
||||||
- Edge connections mapping from_port to to_port between nodes
|
|
||||||
|
|
||||||
## Outputs
|
|
||||||
|
|
||||||
- Executed workflow results stored in the graph's output nodes
|
|
||||||
- Cooked graph ready for inspection, replay, or deployment
|
|
||||||
- Potential error states if node dependencies are missing or ports don't match
|
|
||||||
|
|
||||||
## Failure Modes
|
|
||||||
|
|
||||||
- Missing node dependencies causing undefined variable errors
|
|
||||||
- Port mismatch in edge connections leading to no data flow
|
|
||||||
- Incomplete graph definition causing cook() to fail
|
|
||||||
- Model API key missing or invalid for LLMAgent nodes
|
|
||||||
|
|
||||||
## Source
|
|
||||||
|
|
||||||
Extracted from: [https://github.com/temiroff/Blacknode.git](https://github.com/temiroff/Blacknode.git)
|
|
||||||
Confidence: 0.95
|
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
# Commands: graph-based-node-workflow
|
|
||||||
|
|
||||||
## Available Commands
|
|
||||||
|
|
||||||
- `/skill graph-based-node-workflow` — Load this skill
|
|
||||||
- `/run graph-based-node-workflow` — Execute workflow
|
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
# Examples: graph-based-node-workflow
|
|
||||||
|
|
||||||
## Usage Example
|
|
||||||
|
|
||||||
```python
|
|
||||||
# How to use this skill
|
|
||||||
# Inputs: bn.Graph() - the graph container for the workflow, Node definitions (Literal, Text, LLMAgent, Concat, Output, etc.) with specified inputs and outputs, Edge connections mapping from_port to to_port between nodes
|
|
||||||
# Process: Step 1: Initialize a bn.Graph() instance to serve as the workflow container → Step 2: Define individual nodes with their required inputs and outputs (e.g., Literal for data, LLMAgent for inference, Concat for combining, Output for final results) → Step 3: Create edges connecting nodes by specifying source from_port and destination to_port for each data flow
|
|
||||||
# Outputs: Executed workflow results stored in the graph's output nodes, Cooked graph ready for inspection, replay, or deployment, Potential error states if node dependencies are missing or ports don't match
|
|
||||||
```
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
{
|
|
||||||
"name": "graph-based-node-workflow",
|
|
||||||
"version": "1.0.0",
|
|
||||||
"goal": "Create and execute typed node graphs for AI/robotics workflows by defining nodes with inputs/outputs and connecting them with edges, then cooking the graph to run the workflow.",
|
|
||||||
"inputs": [
|
|
||||||
"bn.Graph() - the graph container for the workflow",
|
|
||||||
"Node definitions (Literal, Text, LLMAgent, Concat, Output, etc.) with specified inputs and outputs",
|
|
||||||
"Edge connections mapping from_port to to_port between nodes"
|
|
||||||
],
|
|
||||||
"steps": [
|
|
||||||
"Step 1: Initialize a bn.Graph() instance to serve as the workflow container",
|
|
||||||
"Step 2: Define individual nodes with their required inputs and outputs (e.g., Literal for data, LLMAgent for inference, Concat for combining, Output for final results)",
|
|
||||||
"Step 3: Create edges connecting nodes by specifying source from_port and destination to_port for each data flow",
|
|
||||||
"Step 4: Execute the graph by calling g.cook() to process the defined workflow and produce results"
|
|
||||||
],
|
|
||||||
"outputs": [
|
|
||||||
"Executed workflow results stored in the graph's output nodes",
|
|
||||||
"Cooked graph ready for inspection, replay, or deployment",
|
|
||||||
"Potential error states if node dependencies are missing or ports don't match"
|
|
||||||
],
|
|
||||||
"failure_modes": [
|
|
||||||
"Missing node dependencies causing undefined variable errors",
|
|
||||||
"Port mismatch in edge connections leading to no data flow",
|
|
||||||
"Incomplete graph definition causing cook() to fail",
|
|
||||||
"Model API key missing or invalid for LLMAgent nodes"
|
|
||||||
],
|
|
||||||
"confidence": 0.95,
|
|
||||||
"explanation": "This workflow pattern is reusable across different AI/robotics applications because it provides a standardized way to compose complex pipelines from typed nodes. The pattern can be adapted to various use cases like research pipelines, agent workflows, or robotics control graphs by simply adding/removing nodes and edges while maintaining the same graph-cooking execution model.",
|
|
||||||
"source_repo": "https://github.com/temiroff/Blacknode.git",
|
|
||||||
"score": 1.0
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
---
|
||||||
|
name: text-concatenation
|
||||||
|
version: 1.0.0
|
||||||
|
description: Concatenate two text inputs using Blacknode node graph
|
||||||
|
inputs:
|
||||||
|
- text_a
|
||||||
|
- text_b
|
||||||
|
steps:
|
||||||
|
- Create a Blacknode Graph instance
|
||||||
|
- Add a Text node with param value set to text_a
|
||||||
|
- Add a second Text node with param value set to text_b
|
||||||
|
- Add a Concat node that accepts inputs 'a' and 'b' and outputs 'value'
|
||||||
|
- Add an Output node with input port 'value'
|
||||||
|
- Connect first Text node 'value' port to Concat 'a' port
|
||||||
|
- Connect second Text node 'value' port to Concat 'b' port
|
||||||
|
- Connect Concat 'value' port to Output 'value' port
|
||||||
|
- Invoke graph cook on Output 'value' to evaluate and return result
|
||||||
|
outputs:
|
||||||
|
- concatenated_text
|
||||||
|
tags: []
|
||||||
|
metadata:
|
||||||
|
source_repo: https://github.com/temiroff/Blacknode.git
|
||||||
|
extracted_at: ''
|
||||||
|
confidence: 0.9
|
||||||
|
---
|
||||||
|
|
||||||
|
# text-concatenation
|
||||||
|
|
||||||
|
Concatenate two text inputs using Blacknode node graph
|
||||||
|
|
||||||
|
## Steps
|
||||||
|
|
||||||
|
1. Create a Blacknode Graph instance
|
||||||
|
2. Add a Text node with param value set to text_a
|
||||||
|
3. Add a second Text node with param value set to text_b
|
||||||
|
4. Add a Concat node that accepts inputs 'a' and 'b' and outputs 'value'
|
||||||
|
5. Add an Output node with input port 'value'
|
||||||
|
6. Connect first Text node 'value' port to Concat 'a' port
|
||||||
|
7. Connect second Text node 'value' port to Concat 'b' port
|
||||||
|
8. Connect Concat 'value' port to Output 'value' port
|
||||||
|
9. Invoke graph cook on Output 'value' to evaluate and return result
|
||||||
|
|
||||||
|
## Inputs
|
||||||
|
|
||||||
|
- text_a
|
||||||
|
- text_b
|
||||||
|
|
||||||
|
## Outputs
|
||||||
|
|
||||||
|
- concatenated_text
|
||||||
|
|
||||||
|
## Failure Modes
|
||||||
|
|
||||||
|
- Port name mismatch causes connection error
|
||||||
|
- Missing runtime or graph not initialized
|
||||||
|
- Cook on nonexistent node returns error
|
||||||
|
|
||||||
|
## Source
|
||||||
|
|
||||||
|
Extracted from: [https://github.com/temiroff/Blacknode.git](https://github.com/temiroff/Blacknode.git)
|
||||||
|
Confidence: 0.9
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
# Commands: text-concatenation
|
||||||
|
|
||||||
|
## Available Commands
|
||||||
|
|
||||||
|
- `/skill text-concatenation` — Load this skill
|
||||||
|
- `/run text-concatenation` — Execute workflow
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
# Examples: text-concatenation
|
||||||
|
|
||||||
|
## Usage Example
|
||||||
|
|
||||||
|
```python
|
||||||
|
# How to use this skill
|
||||||
|
# Inputs: text_a, text_b
|
||||||
|
# Process: Create a Blacknode Graph instance → Add a Text node with param value set to text_a → Add a second Text node with param value set to text_b
|
||||||
|
# Outputs: concatenated_text
|
||||||
|
```
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
{
|
||||||
|
"name": "text-concatenation",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"goal": "Concatenate two text inputs using Blacknode node graph",
|
||||||
|
"inputs": [
|
||||||
|
"text_a",
|
||||||
|
"text_b"
|
||||||
|
],
|
||||||
|
"steps": [
|
||||||
|
"Create a Blacknode Graph instance",
|
||||||
|
"Add a Text node with param value set to text_a",
|
||||||
|
"Add a second Text node with param value set to text_b",
|
||||||
|
"Add a Concat node that accepts inputs 'a' and 'b' and outputs 'value'",
|
||||||
|
"Add an Output node with input port 'value'",
|
||||||
|
"Connect first Text node 'value' port to Concat 'a' port",
|
||||||
|
"Connect second Text node 'value' port to Concat 'b' port",
|
||||||
|
"Connect Concat 'value' port to Output 'value' port",
|
||||||
|
"Invoke graph cook on Output 'value' to evaluate and return result"
|
||||||
|
],
|
||||||
|
"outputs": [
|
||||||
|
"concatenated_text"
|
||||||
|
],
|
||||||
|
"failure_modes": [
|
||||||
|
"Port name mismatch causes connection error",
|
||||||
|
"Missing runtime or graph not initialized",
|
||||||
|
"Cook on nonexistent node returns error"
|
||||||
|
],
|
||||||
|
"confidence": 0.9,
|
||||||
|
"explanation": "The repo contains example converted workflows; converted_text_pipeline.py demonstrates a simple reusable pattern of two source nodes feeding a concatenation node into an output, applicable to any string joining task in Blacknode.",
|
||||||
|
"source_repo": "https://github.com/temiroff/Blacknode.git",
|
||||||
|
"score": 1.0
|
||||||
|
}
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# Tests: graph-based-node-workflow
|
# Tests: text-concatenation
|
||||||
|
|
||||||
## Test Checklist
|
## Test Checklist
|
||||||
|
|
||||||
Reference in New Issue
Block a user