gitwtfhub

wtf is minimachat?

lnshrivas/minimachat — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TL;DR

A local AI chat app whose memory of facts ages honestly over time, letting you rewind to see what it believed earlier and save answers as reusable documents.

Mindmap

mindmap
  root((minimachat))
    What it does
      Temporal memory
      Timeline scrubbing
      Local file access
    Tech stack
      HTML
      PowerShell
      Python
    Use cases
      Chat with your own AI key
      Save answers as books
      Let the agent edit local files
    Audience
      Vibe coders
      Privacy focused users

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

Run a private AI chat locally with your own API key and no cloud accounts.

REASON 2

See how the assistant's remembered facts change or expire over time.

REASON 3

Save a good chat answer as a reusable document you can reference later.

REASON 4

Let the assistant read, edit, and search files in a local project folder.

What's in the stack?

HTMLJavaScriptPowerShellPython

How it stacks up

lnshrivas/minimachat100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencevibe codergeneralgeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Windows-only today, requires Python 3.10+, PowerShell, and your own API key for an OpenAI-compatible model.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, some bundled parts have their own licenses.

Wtf does this do

minimachat, also called minima, is a local chat application that talks directly to an AI model of your choice while running entirely on your own computer. Its main idea is that it keeps its memory of past facts honest over time. If it remembers a deadline, and that deadline passes, the app visibly strikes it through instead of quietly continuing to treat it as still true. Beyond that, the app lets you drag a timeline slider to scrub back and see exactly what the assistant believed at an earlier point, almost like rewinding its memory. When you tell it to save a good answer, it turns that answer into a standalone document, called a book, that you can reference again later from any other chat, along with a link back to the exact moment it was written. The assistant can also act on your files directly: reading, writing, editing, and searching your local folders, running commands, and searching the web, all without sending anything to an outside company beyond your chosen AI model provider. You bring your own API key and can connect it to any AI service that follows the common OpenAI style API format. Right now the project only runs on Windows, since its local server is written in PowerShell, though the author has flagged a Python based server as the most wanted community contribution to bring it to macOS and Linux. Setting it up involves cloning the repository, installing some Python dependencies for memory and web search, and starting the included server script, after which you open a page in your browser and enter your API details. The project is released under the MIT license, a permissive license that allows free use, modification, and distribution as long as the copyright notice is kept. Some bundled third party components carry their own separate licenses.

Yoink these prompts

Prompt 1
Explain how minima's temporal memory strikes through expired facts.
Prompt 2
Walk me through installing and running minimachat's PowerShell server on Windows.
Prompt 3
Help me set up minimachat with an OpenAI compatible API key.
Prompt 4
Describe how minima's book feature turns a chat answer into a reusable document.

Frequently asked questions

wtf is minimachat?

A local AI chat app whose memory of facts ages honestly over time, letting you rewind to see what it believed earlier and save answers as reusable documents.

What language is minimachat written in?

Mainly HTML. The stack also includes HTML, JavaScript, PowerShell.

What license does minimachat use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, some bundled parts have their own licenses.

How hard is minimachat to set up?

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

Who is minimachat for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

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