Install and run

One command. Nothing else to install, unless you want backtests in Python.

Requirements

  • Node.js ≥ 20.9 — Windows, macOS or Linux.
  • Optional: Python with pandas, for the Backtest tool.
  • Optional, Linux: zenity, for the native folder picker.

Run

npx bytnode-ai

Starts BytNode-AI on http://localhost:3777 and opens your browser. Two options:

--port NListen on another port.
--no-openDo not open the browser.

Update

npx bytnode-ai@latest

Your data is outside the package (see below), so an update never touches it.

Run from source

git clone https://github.com/benjfrem07/bytnode-ai
cd bytnode-ai/bytnode-agent-ai
npm install
npm run dev

Same address, http://localhost:3777. The repository is MIT licensed.

Where things live

WhatWhere
Keys, agents, conversationsYour browser’s localStorage. They never leave it except inside your own requests.
Working foldersThe folder you pick per agent, or ~/.bytnode-ai/workspaces/ by default.
Your skills~/.bytnode-ai/skills/
Subscription agents~/.bytnode-ai/agents/, installed on first click. An agent already on your machine is recognised.