git404hub

what is genie fr?

wizard142/genie — explained in plain English

Analysis updated 2026-05-18

8PythonAudience · vibe coderComplexity · 2/5Setup · easy

tl;dr

A terminal tool that turns plain English requests into real Linux or Windows commands, shows what they do, and only runs them after you confirm.

vibe map

mindmap
  root((genie))
    What it does
      Plain English to commands
      Shows before running
      Confirms before executing
    Tech stack
      Python
      PowerShell
      Multiple AI providers
    Use cases
      Beginner terminal help
      Safe command execution
      Cross distro support
    Audience
      Linux 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 make with this?

VIBE 1

Install software or run system commands by describing what you want in plain English.

VIBE 2

Learn real terminal commands over time by seeing the explanation before each one runs.

VIBE 3

Get a safety check on destructive or catastrophic commands before they can run.

what's the stack?

PythonPowerShellGroqOllamaAnthropic Claude

how it stacks up fr

wizard142/genie100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencevibe coderdeveloperresearcher

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

how do i run it?

Difficulty · easy time til it works · 5min

Works without any AI provider for basic tasks, but full functionality needs a free or local AI provider set up.

in plain english

Genie is a terminal helper for people who find Linux and Windows commands hard to remember. Instead of memorizing exact syntax, you type what you want in plain English, prefixed with /genie on Linux or just genie on Windows, and it shows you the real command it would run, along with a short explanation of what that command does. Nothing runs until you press enter to confirm, type n to cancel, or c to copy the command instead. The README explains that genie is built to teach as you go rather than hide the terminal from you, so over time a person using it should start remembering the commands themselves. It works across many different Linux distributions, including Arch-based systems, Debian and Ubuntu, Fedora, openSUSE, Alpine, Void, and Gentoo, automatically using the right package manager for whichever one you have. It also runs natively on Windows, generating PowerShell commands and using winget to install programs. Safety is a core focus. Commands are sorted into levels: simple read-only commands just get shown and confirmed, ones that change your system get a yellow warning, destructive commands like deleting a folder require typing yes first, and a short list of truly catastrophic commands, like wiping a whole drive, are blocked outright no matter what the AI suggests. Genie needs an AI provider to turn your English request into a command. It supports several options, including free tiers from Groq, Google Gemini, and OpenRouter, a paid option through Anthropic Claude, and Ollama for running a model entirely on your own computer at no cost. You can set up more than one provider, and genie will automatically try another if the first one is busy or down. Common tasks like installing software or checking disk space also work without any AI provider configured at all. The whole tool is a single Python file with no extra dependencies to install.

prompts (copy fr)

prompt 1
Walk me through installing genie on my Linux distribution and setting up an AI provider.
prompt 2
Explain how genie decides whether a command is safe, needs a warning, or should be blocked.
prompt 3
Show me how to set up more than one AI provider so genie can fall back if one is busy.
prompt 4
Help me use genie's dry run option to preview a command without actually running it.

Frequently asked questions

what is genie fr?

A terminal tool that turns plain English requests into real Linux or Windows commands, shows what they do, and only runs them after you confirm.

What language is genie written in?

Mainly Python. The stack also includes Python, PowerShell, Groq.

How hard is genie to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is genie for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.