Build a Local AI Agent with RGB in 15 Minutes

import { createInterface } from 'node:readline/promises';
import { completion, cancel, loadModel, QWEN3_600M_INST_Q4 } from '@qvac/sdk';
import { Funnel, ToolRegistry, confirmReadback } from '@kaleidorg/mind';
import { McpToolSource } from '@kaleidorg/mind/mcp';
import { createQvacProvider } from '@kaleidorg/mind/qvac';

// 1. kaleido-mcp on signet, launched over stdio
const kaleido = new McpToolSource({
  id: 'kaleido',
  transport: {
    kind: 'stdio',
    command: 'npx',
    args: ['-y', 'kaleido-mcp'],
    env: {
      PATH: process.env.PATH,
      HOME: process.env.HOME,
      KALEIDO_NETWORK: 'signet',
      RLN_NODE_URL: 'http://localhost:3001',
    },
  },
});
await kaleido.connect();

// 2. A local model through QVAC (downloaded on first run)
const modelId = await loadModel({
  modelSrc: QWEN3_600M_INST_Q4,
  modelType: 'llm',
  modelConfig: { ctx_size: 8192, tools: true },
});
const provider = createQvacProvider({ completion, cancel, getModelId: () => modelId });

// 3. The tiered funnel, with a confirmation prompt before any spend
const funnel = new Funnel({ provider, tools: new ToolRegistry([kaleido]) });
const rl = createInterface({ input: process.stdin, output: process.stdout });

while (true) {
  const text = await rl.question('\n> ');
  if (!text.trim()) continue;
  const out = await funnel.runTurn(text, {
    onConfirm: async (call) => {
      const answer = await rl.question(`${confirmReadback(call)} [y/N] `);
      return { approved: answer.trim().toLowerCase() === 'y' };
    },
  });
  console.log(out.text);
}

import { Funnel, confirmReadback } from '@kaleidorg/mind';
import { MockWallet, scriptedProvider } from '@kaleidorg/mind/testing';

const wallet = new MockWallet();
const funnel = new Funnel({ provider: scriptedProvider(), tools: wallet.registry() });

const out = await funnel.runTurn('what is my balance?', {
  onConfirm: async (call) => {
    console.log(confirmReadback(call));
    return { approved: true };
  },
});
console.log(out.text);