whatisgithub

What is zhuanglema?

liyupi/zhuanglema — explained in plain English

Analysis updated 2026-05-18

60JavaScriptAudience · vibe coderComplexity · 2/5Setup · moderate

In one sentence

A desktop app where you type a plain-language install request and AI generates a ready-to-run, commented installation script.

Mindmap

mindmap
  root((Zhuanglema))
    What it does
      Plain language install requests
      AI generated scripts
      One click execution
    Tech stack
      Python FastAPI
      Electron and React
      SQLite
    Use cases
      Install unfamiliar software
      Review AI plans as admin
      Get official download links
    Audience
      Beginners
      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

Type a request like install MySQL and get a ready-to-run installation script.

USE CASE 2

Read an AI-generated, annotated script before running it, in plain language.

USE CASE 3

Review and moderate AI-generated installation plans through the admin panel.

USE CASE 4

Get official download links for software that is not distributed via package managers.

What is it built with?

PythonFastAPISQLiteElectronReactVite

How does it compare?

liyupi/zhuanglemaektogamat/r3f-webgpu-perffreecodecamp/news-translation-tasks
Stars606060
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-03-16
MaintenanceMaintained
Setup difficultymoderatemoderateeasy
Complexity2/53/52/5
Audiencevibe coderdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10+, Node.js 18+, and an OpenAI-compatible API key to generate plans.

The README does not state a license for this project.

So what is it?

Zhuanglema (which loosely translates as "Did you install it yet?") is a desktop application that helps beginners set up software on their computers by typing a single plain-language request in Chinese. You say something like "I want to install MySQL," and the system identifies the software, picks an appropriate version for your operating system, and generates a ready-to-run installation script with Chinese comments explaining each step. You can then run that script inside the app with one click. The project has three parts. The server is a Python FastAPI backend that handles software search, version lookup, and AI-generated installation plan storage in SQLite. The desktop application is built with Electron, React, and Vite and provides the main user interface where you search, select a version, read the generated plan, and execute it. A separate admin panel lets the project maintainer review all generated plans, handle user feedback, and trigger AI regeneration of a plan that was marked invalid. Version lookups work in tiers to avoid unnecessary AI calls: the server first checks a local cache that is valid for 24 hours, then queries official release sources for common tools like Node.js, Python, and Maven, then searches GitHub releases, and finally falls back to asking the AI model if nothing else worked. Platform detection (Windows, macOS, or Linux) is automatic but can be overridden. The generated installation plan is streamed back as Markdown using server-sent events. It includes an annotated script, an explanation of what each part does, and suggestions for what to do after installation. For software distributed through official websites rather than package managers (VS Code, IntelliJ IDEA, etc.), the plan links directly to the official download page instead of embedding a script. The app uses any OpenAI-compatible language model API, with DeepSeek-chat as the default. After installing, users can mark a plan as helpful or unhelpful and leave text comments that the admin panel aggregates for review.

Copy-paste prompts

Prompt 1
Help me set up the FastAPI server and desktop app for Zhuanglema locally.
Prompt 2
Explain how Zhuanglema's tiered version lookup avoids unnecessary AI calls.
Prompt 3
Show me how to configure my own OpenAI-compatible API key for Zhuanglema.
Prompt 4
Walk me through how the admin panel reviews and regenerates installation plans.

Frequently asked questions

What is zhuanglema?

A desktop app where you type a plain-language install request and AI generates a ready-to-run, commented installation script.

What language is zhuanglema written in?

Mainly JavaScript. The stack also includes Python, FastAPI, SQLite.

What license does zhuanglema use?

The README does not state a license for this project.

How hard is zhuanglema to set up?

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

Who is zhuanglema for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.