TuxGenie 🧞
Your wish is my command. AI-powered Linux assistant — fix any problem in plain English.
████████╗██╗ ██╗██╗ ██╗ ██████╗ ███████╗███╗ ██╗██╗███████╗
██╔══╝██║ ██║╚██╗██╔╝██╔════╝ ██╔════╝████╗ ██║██║██╔════╝
██║ ██║ ██║ ╚███╔╝ ██║ ███╗█████╗ ██╔██╗ ██║██║█████╗
██║ ██║ ██║ ██╔██╗ ██║ ██║██╔══╝ ██║╚██╗██║██║██╔══╝
██║ ╚██████╔╝██╔╝ ██╗╚██████╔╝███████╗██║ ╚████║██║███████╗
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝╚═╝╚══════╝
TuxGenie — Free AI (Gemini · Groq · Z.ai · …) or Claude · Open Source
What is TuxGenie?
TuxGenie is your AI co-pilot for Linux. Describe any problem in plain English and TuxGenie will diagnose it, explain what's wrong, and fix it — step by step, with your approval at every stage.
No more Googling error messages. No more copying random commands from Stack Overflow. Just tell TuxGenie what's wrong.
$ tuxgenie
TuxGenie > my nginx won't start after I edited the config
✦ Step 1 [SAFE] Check nginx config for syntax errors
nginx -t
Run this step? [y/n/skip/abort]: y
nginx: [emerg] unexpected "}" in /etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed
✦ Step 2 [SAFE] Show the problem line in context
sed -n '38,46p' /etc/nginx/nginx.conf
Run this step? [y/n/skip/abort]: y
✦ Step 3 [MODERATE] Fix the missing semicolon on line 41
...
Install
Any Linux distro (recommended)
curl -fsSL https://tuxgenie.com/install.sh | bash
Detects your package manager (apt / dnf / pacman / zypper / apk), installs the
.deb on Debian-family systems, or the release wheel / PyPI package everywhere else.
Debian / Ubuntu / Linux Mint (manual .deb)
# Download the latest .deb from GitHub Releases, then:
sudo dpkg -i tuxgenie_*_all.deb
Download latest .deb →
Any Linux distro (pip)
pip install tuxgenie
# or: python3 -m pip install --user --upgrade tuxgenie
From source
git clone https://github.com/ramchandragada/tuxgenie.git
cd tuxgenie
pip install .
Which distros are supported?
TuxGenie is built for every Linux user. It detects your package manager
(apt, dnf, pacman, zypper, apk, …), adapts first-run setup and catalogs, and
u self-update works for both .deb and pip installs.
| Debian family (Ubuntu, Mint, Pop!_OS, Debian, …) | Other distros (Fedora, Arch, openSUSE, Alpine, …) |
|---|
| AI fix / diagnose / install, system updates | ✅ | ✅ |
| Distro-aware first-run (updates, codecs, Flatpak, firewall) | ✅ | ✅ |
.deb install + app-menu icon + windowed app | ✅ | — (pip / curl installer; runs in your terminal) |
| App catalog | ✅ full | ✅ Flatpak + native packages adapted per distro |
First run
On first launch TuxGenie asks which AI you'd like to use (Gemini is the default —
just press Enter):
You can also set a key via environment variable and skip the prompt:
export GEMINI_API_KEY="..." # Google Gemini (free tier)
# or
export GROQ_API_KEY="gsk_..." # Groq (free tier)
# or
export ZAI_API_KEY="..." # Z.ai GLM Flash (free)
# or
export SAMBANOVA_API_KEY="..." # SambaNova (free tier)
# or
export OPENROUTER_API_KEY="sk-or-..." # OpenRouter (free tier)
# or
export ANTHROPIC_API_KEY="sk-ant-..." # Claude
tuxgenie
Switch providers anytime from Settings → Switch AI provider. Terminal
commands (apt, systemctl, …) run without any key — always free.
Auto-switch on limits: if you add keys for more than one free provider
(Gemini, Groq, Z.ai, SambaNova, OpenRouter), TuxGenie automatically rotates between them when a
free tier hits its rate limit — so a task never stalls. It never auto-switches to
paid Claude (no surprise charges). Toggle it in
Settings → Auto-switch on limits.
Features
You never have to pick a number — just type what you need in plain English. But every capability also has a menu entry:
🚀 Start here
| # | Feature | What it does |
|---|
| 1 | Fix a Problem | Describe any issue in plain English — TuxGenie diagnoses and fixes it |
| 2 | Health Check | Full dashboard: CPU, memory, disk, temps, failed services |
🔧 Fix something
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
