PQWERAI

Wallet guide · AI Workflows

Connect AI steps like building blocks.

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.

Automate AI tasks without writing code.

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.

AI market: Deployed on testnet

Your first workflow in two minutes

  1. Open AI Workflows

    Start the wallet and press Ctrl+Shift+8, or choose AI Workflows in the menu. It opens in Simple mode.

  2. Pick a template

    Choose AI chat. Simple mode shows only the text you can change.

  3. Start your model

    AI nodes use your own model through MeshLLM. If none is running, open the AI page and start Local model (the approved Bonsai model).

  4. Type and run

    Write your question and press Run (F5). Each node shows its state; the answer appears under Results.

Build your own workflow

  1. Switch to Advanced

    The node library, every parameter, the problems list and the run log appear.

  2. Add nodes

    Drag a node from the library, or right-click the canvas and type its name.

  3. Connect ports

    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.

  4. Check, run and keep it

    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.

Templates

Nine starting points. Open one, change the text and run it; in Advanced mode you can change every node.

TemplateWhat it doesCost
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.9Bullet-point summary, then the same summary in Italian.Free, local
Sort messages by type New in 0.8.9Label 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.9Pull named fields out of an invoice or e-mail and save them as JSON.Free, local
Balance report New in 0.8.9Block 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.

Recipes

Four small workflows you can build from the library.

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).

Answer only real questions

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.

Check a provider's price before paying

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.

Turn every address in a text into balances

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.

What you approve, and what stays on your PC

  • Nodes that pay or sign (Escrow, Settlement, Submit Transaction, Fine-Tuning) stop and show the maximum cost. Nothing is paid until you approve and type your password in the wallet's own dialog.
  • The workflow engine never holds a key or a password, and never retries a payment by itself.
  • AI nodes run on your own model; your text leaves the PC only when you send it to a paid provider through Escrow.
  • Files are read only from the workflow data folder and written only to the output folder. A workflow file holds no paths.
  • Imported files are checked: only known node types and parameters, at most 1 MiB, 200 nodes and 600 connections.
  • Test PQAI has no monetary value. Results from a model can be wrong: check them before you act on them.

When something stops

A failed node shows the reason and a suggested fix. The most common ones:

MessageWhat 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.
Node reference and keyboard shortcuts

Node reference

Every node in the library, by category. Ports are colour-coded by the kind of value they carry.

AI Models

NodeWhat it doesCost
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.9A paragraph, bullet points or one sentence.Free
Classify New in 0.8.9The model picks one of up to three labels; the text goes out on that label's port.Free
Extract Fields New in 0.8.9Fills the field names you list (for example name, date, amount) and returns JSON.Free
Translate New in 0.8.9Translates the text into the language you type.Free

Agents

NodeWhat it doesCost
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

Training

NodeWhat it doesCost
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

MeshLLM

NodeWhat it doesCost
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

Payments

NodeWhat it doesCost
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

Blockchain

NodeWhat it doesCost
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.9The current block number.Free
Balance New in 0.8.9The PQAI balance of an address.Free

Storage

NodeWhat it doesCost
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

Logic

NodeWhat it doesCost
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.9Stops the branch with your own message when a test fails.Free

Text & Data

NodeWhat it doesCost
Template New in 0.8.9Builds a text in which {{a}}, {{b}} and {{c}} are replaced by the inputs.Free
Transform Text New in 0.8.9Trim, change case, shorten, replace, split into lines, count characters or words.Free
Extract Pattern New in 0.8.9Finds text with a regular expression, for example every 0x address.Free
Parse JSON New in 0.8.9Turns text into JSON, including JSON hidden inside a model's answer.Free
Get Field New in 0.8.9Reads one value by path, for example items[0].name.Free
Build JSON New in 0.8.9Makes a JSON object from up to three inputs.Free
List New in 0.8.9Count, take, sort, de-duplicate, reverse, filter or join.Free
Calculate New in 0.8.9Add, subtract, multiply, divide, min, max, percent, round.Free
Convert Units New in 0.8.9Wei to PQAI and back (1 PQAI = 10^18 wei).Free
Hash New in 0.8.9SHA-256 or Keccak-256 as 0x hex.Free

Output

NodeWhat it doesCost
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

Keyboard shortcuts

F5
Run
Esc
Stop a run
Ctrl+Z / Ctrl+Y
Undo / redo
Ctrl+C / V / D
Copy, paste, duplicate
Ctrl+G
Group the selection
Ctrl+L
Tidy the layout
Ctrl+A
Select all
Del
Delete the selection
Ctrl+wheel
Zoom
Shift+drag
Select with a box