whatisgithub

What is assemblix?

nmamizerov/assemblix — explained in plain English

Analysis updated 2026-05-18

14PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

In one sentence

A drag and drop visual builder for AI agent workflows that you can self host with a single Docker command.

Mindmap

mindmap
  root((Assemblix))
    What it does
      Visual AI workflow builder
      Drag and drop canvas
      Real time execution
    Tech stack
      Python backend
      React frontend
      Docker Compose
      PostgreSQL
    Use cases
      Multi provider AI agents
      HTTP tool calling
      Knowledge base retrieval
    Audience
      Vibe coders
      Self hosters

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

Build a multi step AI agent workflow visually without writing glue code.

USE CASE 2

Connect a workflow to OpenAI, Gemini, or DeepSeek with automatic fallback between providers.

USE CASE 3

Give an agent access to your own documents through a knowledge base node for retrieval based answers.

USE CASE 4

Self host the whole platform on your own server with one install script.

What is it built with?

PythonReactDockerPostgreSQLRedis

How does it compare?

nmamizerov/assemblix0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencevibe coderdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 5min

Needs Docker with Compose v2, the install script generates required secret keys automatically.

MIT with a Commons Clause, free to use and self host, but a separate paid license covers built in billing features.

So what is it?

Assemblix is a visual platform for building AI agents and workflow automations. Instead of writing code, you drag nodes onto a canvas and wire them together to create a working AI workflow, for example a chain that starts, calls an agent, checks a condition, makes an HTTP request, and ends. You can then run that workflow and watch it execute in real time. Workflows are built as node graphs on a canvas powered by React Flow. Agent nodes can call one of several AI model providers, including OpenAI, Google Gemini, and DeepSeek, with automatic retries and fallback if one provider fails. Condition nodes let you branch logic, HTTP request nodes let an agent call outside APIs safely, and knowledge base nodes let agents pull in your own documents for retrieval augmented answers. The platform also supports multiple organizations and projects, stores chat sessions, and includes monitoring features like health checks and per step cost tracking for the AI calls a workflow makes. Assemblix is source available under an MIT license with a Commons Clause, meaning it is free to use, modify, and run yourself, but a separate paid Enterprise license covers billing and payment features, which are turned off by default. Getting started takes about a minute if you have Docker installed. A single install script clones the project, generates the required secret keys, writes the configuration file, and starts the whole stack for you, ending with a working app at localhost port 8080 where you create an account and build your first workflow. If you would rather set things up by hand, the README also documents a manual Docker Compose setup, a development mode with live reload for the web and API pieces, and a way to run everything natively on your machine using Postgres in Docker alongside locally run frontend and backend processes. An optional Redis and worker queue tier can be turned on later if you want workflows to run across multiple machines instead of one. The project is also built to be extended: new node types can be added as separate installable packages that get picked up automatically, without changing the core Assemblix code or needing a database migration.

Copy-paste prompts

Prompt 1
Walk me through running the Assemblix one line install script and creating my first workflow.
Prompt 2
Help me build an Assemblix workflow that calls an AI agent, checks a condition, and hits an HTTP endpoint.
Prompt 3
Explain how to write a custom node package for Assemblix that gets auto discovered.
Prompt 4
Show me how to enable the optional Redis and worker queue tier in Assemblix.

Frequently asked questions

What is assemblix?

A drag and drop visual builder for AI agent workflows that you can self host with a single Docker command.

What language is assemblix written in?

Mainly Python. The stack also includes Python, React, Docker.

What license does assemblix use?

MIT with a Commons Clause, free to use and self host, but a separate paid license covers built in billing features.

How hard is assemblix to set up?

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

Who is assemblix for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.