gitwtfhub

wtf is chatnest?

ugui3u/chatnest — explained in plain English

Analysis updated 2026-05-18

86HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

An open source, placeholder-only personal AI chat web app with both a frontend-only demo and a full-stack version with local memory search.

Mindmap

mindmap
  root((chatnest))
    What it does
      Personal AI chat app
      Placeholder branding
      Frontend and full-stack modes
    Tech stack
      Python
      HTML
      ChromaDB
      jieba BM25
    Use cases
      Preview chat UI
      Run full chat backend
      Local memory search
    Audience
      Hobbyist developers
      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

Why would anyone build with this?

REASON 1

Preview or customize an AI chat interface using the frontend-only demo

REASON 2

Run the full chat app with streaming responses and tool status display

REASON 3

Add local memory search over your own notes using ChromaDB and BM25

REASON 4

Swap in your own logo, icons, and fonts using the separate asset pack

What's in the stack?

PythonHTMLChromaDBjieba

How it stacks up

ugui3u/chatnestelder-plinius/entheavanyapr/makaroshki
Stars868484
LanguageHTMLHTMLHTML
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencedevelopergeneralvibe coder

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires downloading a separate asset pack for logo and fonts, and generating your own secret key and password for the full-stack version.

Free for non-commercial copying, modification, and redistribution, commercial use is not allowed, credit is appreciated but not required.

Wtf does this do

chatnest is an open source, placeholder-only version of the author's personal AI chat web app. The public repository intentionally leaves out the real logo, custom fonts, private prompts, environment secrets, databases, uploaded files, memory data, and logs, since those pieces cannot legally be shared. Anyone using the project needs to download a separate asset pack and swap in their own logo, icons, and fonts, using materials they own or are licensed to use. There are two ways to run it, and the README suggests picking based on what you want. A frontend-only demo folder shows the interface using fake data, with no backend or API key needed, useful for just looking at or modifying the UI. A full-stack folder contains the complete app, both frontend and backend together, since the interface and backend are closely tied together, for example when displaying the model's step by step reasoning. The full-stack version includes features like switching between AI models, streaming responses, showing tool usage and reasoning summaries, file uploads, saved conversation history, a memory interface, and profile and preference settings. The full-stack version also includes an optional local memory retrieval service. It searches a user's own local text memory files using a combination of vector search through ChromaDB and keyword search using jieba and BM25, without needing any extra API key, and the vector database itself is generated locally on the user's machine from their own memory files, such as a CLAUDE.md file, a profile file, and a memories folder. Getting the frontend demo running is as simple as starting a basic Python web server in that folder and opening it in a browser, or just double clicking the HTML file. Running the full-stack version involves setting up a Python virtual environment, installing dependencies, copying an example environment file, generating a secret key, setting a password, and then running a startup script, with a separate script available if the optional memory service should also be enabled. The project is licensed for non-commercial use only: copying, modifying, and redistributing it for non-commercial purposes is allowed, commercial use is not, and giving credit to the author is appreciated but not required.

Yoink these prompts

Prompt 1
Help me run the frontend-demo folder locally with Python's http.server.
Prompt 2
Walk me through setting up the full-stack version, including generating a CHAT_SECRET and CHAT_PASSWORD.
Prompt 3
Explain how to enable the optional local memory retrieval service with run-with-memory.sh.
Prompt 4
Show me how to replace the placeholder logo and fonts using the BRANDING.md instructions.

Frequently asked questions

wtf is chatnest?

An open source, placeholder-only personal AI chat web app with both a frontend-only demo and a full-stack version with local memory search.

What language is chatnest written in?

Mainly HTML. The stack also includes Python, HTML, ChromaDB.

What license does chatnest use?

Free for non-commercial copying, modification, and redistribution, commercial use is not allowed, credit is appreciated but not required.

How hard is chatnest to set up?

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

Who is chatnest for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.