Summarize a document stored on IPFS
Text Input (the CID) → Retrieve → Summarize (bullets) → Text. Add File to keep the summary.
Retrieve needs your IPFS node running (Studio → IPFS).
Wallet guide · AI Workflows
Chain a local model, agents, the AI market, contract reads and IPFS into one workflow. Run it with one button; every paid step asks you first.
AI Workflows is a page of the Windows wallet. Each box (node) does one real thing — ask a model, read the chain, pay a provider, save a file — and the lines carry its result to the next box.
Start the wallet and press Ctrl+Shift+8, or choose AI Workflows in the menu. It opens in Simple mode.
Choose AI chat. Simple mode shows only the text you can change.
AI nodes use your own model through MeshLLM. If none is running, open the AI page and start Local model (the approved Bonsai model).
Write your question and press Run (F5). Each node shows its state; the answer appears under Results.
The node library, every parameter, the problems list and the run log appear.
Drag a node from the library, or right-click the canvas and type its name.
Drag from an output (right) to an input (left). Colours show the value type; the editor refuses a connection whose types do not match, or one that would make a loop.
The problems list names each node to fix; errors block Run. After a run, Save version keeps a numbered copy and Export writes a .pqflow.json file you can share.
Nine starting points. Open one, change the text and run it; in Advanced mode you can change every node.
| Template | What it does | Cost |
|---|---|---|
| AI chat | Ask your local model; a Memory node keeps the conversation. | Free, local |
| Multi-agent collaboration | A planner, a critic and a writer take turns on your task. | Free, local |
| MeshLLM paid inference | Find a provider on chain, see the price, pay through escrow, get the answer. | Paid: asks first |
| AI training: evaluate a model | Score your local model on a JSONL dataset. | Free, local |
| Smart-contract interaction | Read a contract on chain 20777, check the result and pin it to IPFS. | Free |
| Summarize and translate New in 0.8.9 | Bullet-point summary, then the same summary in Italian. | Free, local |
| Sort messages by type New in 0.8.9 | Label a message as a question, a complaint or praise; each label goes its own way. | Free, local |
| Extract data to JSON New in 0.8.9 | Pull named fields out of an invoice or e-mail and save them as JSON. | Free, local |
| Balance report New in 0.8.9 | Block height and an address's PQAI balance, written to a report file. | Free |
New in 0.8.9 marks what wallet 0.8.9 added; everything else has been there since 0.8.8.
Four small workflows you can build from the library.
Text Input (the CID) → Retrieve → Summarize (bullets) → Text. Add File to keep the summary.
Retrieve needs your IPFS node running (Studio → IPFS).
Text Input → Classify (question, complaint, praise) → from Label 1 to Inference → Text. The other labels go to Template nodes with a ready reply.
Unused branches are skipped, so the model runs only once more for a question.
Discover Provider → Route Request (cheapest) → Estimate Cost (refuse above 0.05) → Escrow → Text.
Escrow shows the maximum charge and asks for your approval, then your password.
Text Input → Extract Pattern (0x[0-9a-fA-F]{40}) → List (unique) → Loop over a subworkflow with Balance → Result Viewer.
A loop runs up to 50 items; paid or signing nodes are not allowed inside a loop.
data folder and written only to the output folder. A workflow file holds no paths.A failed node shows the reason and a suggested fix. The most common ones:
| Message | What to do |
|---|---|
| “The gateway lists no model” | Start Local model on the AI page, or check the gateway address (Advanced → Select Model). It must be a local http://127.0.0.1 address. |
| “No registered provider serves this model right now” | Providers can be offline. Connect to testnet 20777 on the Network page and try again later. |
| “The quote costs up to … above your limit” | Estimate Cost protected you: raise Refuse above only if you accept the price. |
| A node shows “Skipped” | An earlier branch did not produce its input (for example the other side of a Condition). This is normal. |
| “Start your IPFS node” | Open Studio → IPFS and start the node, then run again. |
| “No training market on chain 20777” | Paid fine-tuning is not on the network yet; use Evaluation to score a model for free. |
Every node in the library, by category. Ports are colour-coded by the kind of value they carry.
| Node | What it does | Cost |
|---|---|---|
| Select Model | Picks a model served by your local MeshLLM gateway (auto = the first one). | Free |
| Load Model | Checks that the model answers before the rest of the workflow runs. | Free |
| Inference | Runs your prompt on the model, with an optional system prompt and memory. | Free |
| Summarize New in 0.8.9 | A paragraph, bullet points or one sentence. | Free |
| Classify New in 0.8.9 | The model picks one of up to three labels; the text goes out on that label's port. | Free |
| Extract Fields New in 0.8.9 | Fills the field names you list (for example name, date, amount) and returns JSON. | Free |
| Translate New in 0.8.9 | Translates the text into the language you type. | Free |
| Node | What it does | Cost |
|---|---|---|
| AI Agent | A model that may call read-only tools (chain height, a balance, a contract read), up to a step limit. | Free |
| Tool | One read-only capability for an agent. | Free |
| Memory | Conversation memory kept on this computer under a name. | Free |
| Multi-Agent | Two to six roles take turns on the same task; the last role writes the answer. | Free |
| Node | What it does | Cost |
|---|---|---|
| Dataset | A JSONL file of prompt/expected pairs from your data folder or IPFS. | Free |
| Evaluation | Runs the model on every row and scores the answers. | Free |
| Fine-Tuning | Paid training. Chain 20777 has no training market yet, so it stops with that message and pays nothing. | Pays · asks first |
| Node | What it does | Cost |
|---|---|---|
| Discover Provider | Finds registered providers of a model on chain. | Free |
| Route Request | Chooses the cheapest provider, or the first one. | Free |
| Relay | Reaches providers through the encrypted AI P2P overlay. | Free |
| Node | What it does | Cost |
|---|---|---|
| Estimate Cost | Gets a signed quote and refuses it above your limit. Nothing is paid. | Free |
| Escrow | Funds the job, sends the request and returns the verified answer. | Pays · asks first |
| Settlement | Accepts the provider's result now, or finalizes after the challenge window. | Signs · asks first |
| Node | What it does | Cost |
|---|---|---|
| Read Contract | Calls a view function, for example totalSupply(). | Free |
| Verify Transaction | Checks a receipt and whether its block is final. | Free |
| Submit Transaction | Sends a transfer or a contract call from your wallet. | Pays · asks first |
| Block Height New in 0.8.9 | The current block number. | Free |
| Balance New in 0.8.9 | The PQAI balance of an address. | Free |
| Node | What it does | Cost |
|---|---|---|
| IPFS Upload | Adds a value to your local IPFS node and pins it. | Free |
| Retrieve | Reads content by CID (size limited). | Free |
| Verify CID | Recomputes a raw-leaf CID and compares it. | Free |
| Node | What it does | Cost |
|---|---|---|
| Text Input | A value you type, or that Simple mode asks for. | Free |
| Condition | Sends the value to 'true' or 'false'; the other branch is skipped. | Free |
| Router | Sends text to the first route whose keyword it contains. | Free |
| Merge | Joins several values in connection order. | Free |
| Loop | Runs a saved subworkflow once per line or list item (up to 50). | Free |
| Check New in 0.8.9 | Stops the branch with your own message when a test fails. | Free |
| Node | What it does | Cost |
|---|---|---|
| Template New in 0.8.9 | Builds a text in which {{a}}, {{b}} and {{c}} are replaced by the inputs. | Free |
| Transform Text New in 0.8.9 | Trim, change case, shorten, replace, split into lines, count characters or words. | Free |
| Extract Pattern New in 0.8.9 | Finds text with a regular expression, for example every 0x address. | Free |
| Parse JSON New in 0.8.9 | Turns text into JSON, including JSON hidden inside a model's answer. | Free |
| Get Field New in 0.8.9 | Reads one value by path, for example items[0].name. | Free |
| Build JSON New in 0.8.9 | Makes a JSON object from up to three inputs. | Free |
| List New in 0.8.9 | Count, take, sort, de-duplicate, reverse, filter or join. | Free |
| Calculate New in 0.8.9 | Add, subtract, multiply, divide, min, max, percent, round. | Free |
| Convert Units New in 0.8.9 | Wei to PQAI and back (1 PQAI = 10^18 wei). | Free |
| Hash New in 0.8.9 | SHA-256 or Keccak-256 as 0x hex. | Free |
| Node | What it does | Cost |
|---|---|---|
| Text | Shows text in the results panel. | Free |
| JSON | Shows a value as formatted JSON. | Free |
| File | Saves the value in your workflow output folder. | Free |
| Result Viewer | Shows every value it receives, with its type. | Free |