explaingit

fzhiyu1/improv-os

Analysis updated 2026-05-18

19JavaScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A web based fake macOS desktop where every app is generated fresh by AI in seconds instead of being loaded from storage.

Mindmap

mindmap
  root((ImprovOS))
    What it does
      AI generated apps
      Fake macOS desktop
    Tech stack
      JavaScript
      Anthropic API
      Node.js
    Use cases
      Instant app generation
      Spotlight search apps
    Audience
      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

Open a fake macOS desktop where every app is freshly generated by AI instead of loaded from storage.

USE CASE 2

Type any idea into Spotlight search and get a working web app built for that description in seconds.

USE CASE 3

Compare the fast 2 to 3 second generation track against the slower, more thorough agent loop track.

USE CASE 4

Self host the desktop shell with your own Anthropic API key.

What is it built with?

JavaScriptHTMLCSSNode.js

How does it compare?

fzhiyu1/improv-osaburousan/typsteditordeedy/glacial-valley
Stars191919
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencevibe coderresearcherdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+ and an Anthropic API key to self host.

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

In plain English

ImprovOS is a web-based desktop that looks and behaves like macOS, with one unusual property: there are no pre-installed applications. When you click an icon in the Dock to open a calculator, the calculator does not open from storage. Instead, an AI model writes the calculator from scratch in about 2 to 3 seconds, and the code streams to your screen live as it is generated. Every time you open the same app, a different version is created. The core idea is that nothing is ever the same twice. The Spotlight search bar works the same way. You can type anything: "Russian Tetris," "cello," or "fish detector," and the AI generates a working web application for that description on the spot. Apps that have been generated before can be cached for instant reopening, and there is a dice button to regenerate a fresh version. There are two generation modes. The fast track produces a self-contained HTML page in 2 to 3 seconds. The slow track runs a longer AI agent loop that writes files, runs checks on its own output, and iterates, taking 16 to 27 seconds but producing more complete results. Generated apps can call a small set of provided APIs to fetch real data or make HTTP requests. Self-hosting requires Node.js 18 or later and an Anthropic API key. There are no npm dependencies for the server. The shell of the desktop (the Dock, menu bar, window management, and Spotlight) is written by hand in plain JavaScript and CSS with no framework. The README is written in Chinese. The project is MIT licensed.

Copy-paste prompts

Prompt 1
Walk me through self hosting ImprovOS with Node.js and my own Anthropic API key.
Prompt 2
Explain the difference between ImprovOS's fast track and slow track app generation modes.
Prompt 3
Show me how ImprovOS's Spotlight search turns a text description into a runnable web app.
Prompt 4
Help me add a new API that generated ImprovOS apps can call for real data.

Frequently asked questions

What is improv-os?

A web based fake macOS desktop where every app is generated fresh by AI in seconds instead of being loaded from storage.

What language is improv-os written in?

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

What license does improv-os use?

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

How hard is improv-os to set up?

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

Who is improv-os for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.