AbstractFlow

AbstractFlow is the visual workflow editor for AbstractFramework.

It is a web package (@abstractframework/flow). It runs a browser editor and a small Node server that serves the built UI and proxies /api/* to AbstractGateway. AbstractGateway owns users, sessions, runtime routing, provider configuration, workflow storage, run execution, ledgers, artifacts, and media catalogs.

Install

npx @abstractframework/flow --gateway-url http://127.0.0.1:8080

For a local checkout:

npm install
npm run dev -- --host 0.0.0.0 --port 3003

Open http://localhost:3003 and sign in with the Gateway user and token created by AbstractGateway. Leave provider/model selectors on Auto (Gateway default) for portable workflows. Gateway/Core capability defaults choose the actual provider/model at run time for the current user/runtime.

Media artifact inputs can be wired from another node or uploaded directly on the node when the artifact pin is unconnected. Uploaded browser files are stored as Gateway artifacts. During Listen Voice waits, Flow records in the browser, uploads the captured audio artifact, and resumes the Gateway run; Flow does not execute local audio or transcription logic itself.

Gateway Setup

export ABSTRACTGATEWAY_USER_AUTH=1
export ABSTRACTGATEWAY_DATA_DIR="$PWD/runtime/gateway"
abstractgateway serve --host 127.0.0.1 --port 8080
cat "$ABSTRACTGATEWAY_DATA_DIR/auth/bootstrap-admin-token"

Use:

• Gateway URL: http://127.0.0.1:8080
• User: admin
• Token: the agw_... token printed by Gateway or stored in auth/bootstrap-admin-token

What Lives Here

• src/ - React/Vite visual editor.
• bin/cli.js - npm CLI/static server and Gateway proxy.
• examples/flows/ - sample VisualFlow JSON files kept for reference/import tests.
• docs/ - external documentation for users and maintainers.

AbstractFlow does not ship a Python package or local execution host. VisualFlow compilation, bundle execution, runtime state, and provider calls are handled by AbstractGateway and AbstractRuntime.

Scripts

npm run dev
npm run build
npm run lint
npm run docs:llms

Documentation

• Getting started
• Web editor
• Architecture
• API and contracts
• VisualFlow JSON
• CLI
• FAQ

Related Projects

• AbstractFramework: https://github.com/lpalbou/AbstractFramework
• AbstractGateway: https://github.com/lpalbou/AbstractGateway
• AbstractRuntime: https://github.com/lpalbou/AbstractRuntime
• AbstractCore: https://github.com/lpalbou/AbstractCore

Policies

• Changelog: CHANGELOG.md
• Contributing: CONTRIBUTING.md
• Security: SECURITY.md
• License: LICENSE