whatisgithub

What is brain?

flujo-app/brain — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A 3D live visualization tool that turns AI agent workflows built in FLUJO into an animated, explorable network you can watch think.

Mindmap

mindmap
  root((brain))
    What it does
      3D flow visualization
      Live execution animation
      Chat with running flows
    Tech stack
      TypeScript
      Docker
      FLUJO
      Three.js
    Use cases
      Debug agent workflows
      Grow autonomous agents
      Monitor live executions
    Audience
      Developers
      AI builders
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Visualize a FLUJO agent workspace as an interactive 3D network instead of flat boxes

USE CASE 2

Watch AI agent workflows execute live with animated signals showing what is running

USE CASE 3

Grow a new autonomous AI agent from a wizard using plain language questions

USE CASE 4

Pause a running agent flow and chat directly with it before resuming

What is it built with?

TypeScriptDockerThree.jsFLUJOWebGL

How does it compare?

flujo-app/brain0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker Desktop or Docker Engine with Compose, plus an existing FLUJO workspace to visualize.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

brain is a visualization and management tool for FLUJO, a system for building AI agent workflows. Instead of showing agent flows as flat boxes on a canvas, brain turns a running FLUJO workspace into a 3D animated network you can fly through in your browser. Each flow becomes a glowing node, connections between flows become pulsing lines, and related flows cluster together into colored groups based on which AI provider or model they use. The visualization is live, not a static snapshot. While a flow is actually running inside FLUJO, brain listens to its event stream and animates the activity in real time: the active node lights up, connections flash as calls happen between flows, and a status strip shows what is currently executing. You can pause a running flow mid-thought and type directly to it through a chat window, with every other flow available to it as a callable tool, then resume where it left off. Beyond watching one workspace, brain includes a wizard for creating new autonomous AI agents from scratch, using three plain-language questions: where the agent's model should run, such as locally through Ollama or through a paid provider like Anthropic or OpenAI, what its goal is in one sentence, and how often it should wake up to work on that goal. Once created, each agent can learn new behaviors by writing its own new flows, install new tools from a registry, and remove behaviors or tools that are not working, all on a repeating schedule. Safety limits are built into brain's own server layer, so an agent cannot delete or overwrite its own core flow and destructive actions can require human approval. Running brain requires Git and Docker installed locally. After cloning the repository, a single docker compose up command starts both brain and FLUJO together, and the tool is reached in a browser at localhost. The project is released under the MIT license and is written in TypeScript.

Copy-paste prompts

Prompt 1
Help me set up brain and FLUJO together using docker compose
Prompt 2
Explain how brain visualizes flow connections as neurons and synapses
Prompt 3
Walk me through the grow-a-brain wizard to create a new autonomous agent
Prompt 4
Show me how to pause a running FLUJO flow and chat with it through brain
Prompt 5
Explain how brain's guardrails stop an agent from overwriting its own core flow

Frequently asked questions

What is brain?

A 3D live visualization tool that turns AI agent workflows built in FLUJO into an animated, explorable network you can watch think.

What language is brain written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, Three.js.

What license does brain use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is brain to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is brain for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.