explaingit

justlucyhq/lucy

Analysis updated 2026-05-18

23TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

A self-hosted, multi-provider AI chat platform with cross-conversation memory, a visual workflow builder, and an embeddable chat widget for teams keeping their own data.

Mindmap

mindmap
  root((lucy ai))
    What it does
      Multi provider AI chat
      Cross session memory
      Visual workflow builder
    Deployment modes
      Standalone browser only
      Connected with Supabase
    Tech stack
      Next.js React
      TypeScript
      Tailwind CSS
      Supabase
    Extras
      Terminal CLI
      Embeddable widget
      MCP connectors

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

Give a team one chat interface that can switch between OpenAI, Claude, Gemini, or local Ollama models mid-conversation.

USE CASE 2

Build multi-step AI pipelines visually with the workflow builder's drag and drop node canvas.

USE CASE 3

Run Lucy in standalone mode with no database for a single user, or connected mode with Supabase for a whole team.

USE CASE 4

Embed Lucy's chat widget into an existing web app with a single script tag.

What is it built with?

TypeScriptNext.jsReactTailwind CSSSupabase

How does it compare?

justlucyhq/lucyad3lre/echoaffaan-m/x-algorithm-score
Stars232323
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity4/54/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Standalone mode needs no setup beyond an API key, connected mode requires a Supabase database for team features and memory.

Copyleft license requiring that modified versions, including ones run as a network service, be released under the same open source terms.

In plain English

Lucy is a self hosted AI chat platform built for teams who want to use AI tools without sending their company data to someone else's cloud. It connects to OpenAI, Anthropic Claude, Google Gemini, and several other providers, as well as local models run through Ollama or LM Studio, all through one interface where you can switch models in the middle of a conversation and watch responses stream in as they are generated. Chat history and settings can be kept entirely in the browser for a zero infrastructure standalone mode, or saved to a Supabase PostgreSQL database when a team needs multiple users and access across devices. In connected mode, Lucy also builds a memory of facts, preferences, and past conversations that carries across sessions, using a mix of search techniques to pull back only what is relevant to the current message, along with a privacy guard meant to avoid storing secrets. A lexical fallback version of memory works even in standalone mode without a database. Beyond chat, Lucy includes a visual workflow builder, a drag and drop canvas where you can wire together multi step AI pipelines from building blocks like an AI agent step, a knowledge base lookup, conditions, filters, and HTTP calls. In connected mode these workflows run on the server and keep going even if you close the browser tab, can be triggered by a schedule, a webhook, or a data change, and will retry automatically if a step fails. There is also a terminal command line client for chatting from any shell, and an integration layer that lets other applications register with Lucy so it can read their data as context and trigger actions on their behalf, plus an embeddable chat widget that can be added to any web page with one script tag. The project is written in TypeScript with Next.js, React, and Tailwind CSS on the frontend, with Supabase as the optional backing database. It is released under the AGPL-3.0 license. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Walk me through setting up Lucy in standalone mode versus connected mode with Supabase.
Prompt 2
Help me design a workflow in Lucy's visual builder that reads from a knowledge base and calls an HTTP endpoint.
Prompt 3
Explain how Lucy's memory system decides what to remember across conversations and how the privacy guard works.
Prompt 4
How do I embed Lucy's chat widget into my existing web application with one script tag?

Frequently asked questions

What is lucy?

A self-hosted, multi-provider AI chat platform with cross-conversation memory, a visual workflow builder, and an embeddable chat widget for teams keeping their own data.

What language is lucy written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, React.

What license does lucy use?

Copyleft license requiring that modified versions, including ones run as a network service, be released under the same open source terms.

How hard is lucy to set up?

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

Who is lucy for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.