✨ Free · Open Source · MIT · Gemini · Groq · SambaNova · OpenRouter · Claude

Linux,
made effortlessly
simple.

TuxGenie is an AI-powered Linux assistant. Describe what you need in plain English — it diagnoses, fixes, installs, and configures your system for you. Try “my PC is slow” for safe one-tap speed fixes. No experience required.

🆓
Free to run — no credit card. Use Google Gemini, Groq, SambaNova or OpenRouter (all free), or Claude for best quality (~$0.01/session). Pick on first launch.
🐧 Install Free ⭐ Star on GitHub
43Built-in Tools
2221-Tap Apps
22AI Tools
…GitHub Stars
🆕 “My PC is slow” → one-tap repair 🆓 Free AI failover (Gemini → Groq…) 📦 Reliable catalogs on every distro 🛡️ Verified, resilient auto-updates ✅ You approve every change
tuxgenie

Works on every major Linux distribution

From stuck to fixed in 3 steps

No manuals. No Stack Overflow. Just describe your problem.

1

Install TuxGenie

One curl command. All 43 built-in tools land on any Linux distro immediately.

2

Pick your AI — four free options

On first launch, choose a free key from Google Gemini, Groq, SambaNova or OpenRouter (no credit card), or Claude for best quality. Change it anytime with k.

3

Describe your problem

Type anything — "my wifi stopped working", "install chrome", "why is it slow?", or any shell command. AI runs only when it truly helps.

43 built-in tools, one terminal

Everything to fix, install, optimise, and secure Linux — plus one-tap catalogs of 222 apps and 22 AI tools. Organised the way you actually think.

[77]

App Catalog · 222 apps

Install from 222 popular Linux apps — browsers, messaging, office, media, graphics, dev tools, gaming, security, and free open-source games. Pick by number, use ranges like 1-5, or just type a word to search. Deterministic installs with Flatpak fallbacks — works on Ubuntu, Fedora, Arch, and more — and TuxGenie asks before it runs.

BraveSignalVS Code SteamBitwardenBlender DockerSyncthingSuperTuxKart 0 A.D.Veloren+ many more
[99]

AI Tools · 22 tools

One-tap installs for AI code editors — Cursor, Windsurf, Zed — plus coding agents (Claude Code, Copilot CLI, Gemini CLI), offline local LLMs (Ollama, GPT4All), and the Local AI Starter Pack that sets up Ollama + Open WebUI in one tap.

CursorWindsurfZed OllamaClaude CodeCopilot CLI Gemini CLIGPT4AllWhisper
📚 Browse the full catalog — every app, AI tool & feature →

Searchable reference of everything TuxGenie can install and do.

🔧 Fix SomethingCommon things that go wrong
[1]🔧
Fix a Problem
Describe any Linux issue in plain English — diagnosed and fixed step by step.
[2]🩺
Health Check
Full system health scan — CPU, memory, disk, services, and update status at a glance.
[3]📶
Internet / WiFi
Diagnose & fix WiFi, DNS, and connectivity problems automatically.
[4]🔊
Sound / Audio
No audio, mic not working, HDMI sound — fixed in minutes.
[5]🖥
Display
Wrong resolution, monitor not detected, multi-display problems solved.
[6]🔵
Bluetooth
Device won't pair or keeps disconnecting — tracked down and fixed.
[7]🖨
Printer Setup
Install any printer, fix printing issues — USB and network printers.
[8]📷
Webcam Fix
Camera not working in Zoom, Teams, or Meet? Fixed immediately.
[9]🛠
Missing Drivers
Detect & install missing GPU, WiFi, printer, audio drivers automatically.
[10]🔐
Permissions
Diagnose and fix "Permission denied" errors with a clear explanation.
📦 Install & Update
[11]📦
Install Software
"I need a video editor" → finds and installs the best option automatically.
[12]🔄
Check for Updates
Safe upgrade analysis — see what's pending, install securely.
[13]⬆️
Upgrade OS Version
Move to the next Ubuntu / Fedora / Debian release with guided, safer steps.
[14]🌍
Find Linux App
"What replaces Photoshop / Word / iTunes?" — finds the best alternative.
🛡️ Protect & Recover
[15]🛡️
Security Check
Harden firewall, SSH, and open ports. Know exactly how exposed you are.
[16]💾
Backup Settings
Snapshot all system configs to .tar.gz before making changes.
[17]↩
Undo Changes
Roll back what TuxGenie did in any previous session instantly.
⚡ Speed & Maintenance
[18]🚀
Performance Boost
Say “my PC is slow” — local scan + safe speed fixes (swappiness, logs, cache, boot), optional AI deep-dive.
[19]💿
Disk Cleanup
Find space hogs and clean up safely — never delete the wrong thing.
[20]⏱
Speed Up Boot
Find why boot is slow and reduce startup time significantly.
[21]🔋
Battery & Power
Improve battery life and fix overheating on laptops.
[22]⚙️
Manage Services
Optimise startup & running services. Understand what's running.
📊 Inspect
[23]🔩
Hardware Info
Full hardware report — CPU, RAM, GPU, storage, and more.
[24]📈
Running Programs
Tame CPU and memory hogs, kill zombies, restore speed.
[25]📋
Explain Logs
Decode cryptic error messages and system logs in plain English.
⚙️ For Developers
[26]📝
Generate Script
Describe a task → get a working bash script instantly.
[27]⏰
Schedule Task
Cron in plain English — no syntax to remember.
[28]🐳
Docker Help
Container troubleshooting, cleanup, and management simplified.
[29]🔑
SSH Setup
Set up & harden SSH — secure remote access without complexity.
[30]🐙
Git Helper
Fix conflicts, undo commits, understand diffs in plain English.
🚀 New · Latest improvementsShipped in recent releases — everyday Linux, faster and safer
[18]🚀
Slow-PC One-Tap Repair
Type “my PC is slow” — local scan (no AI), then safe fixes you approve: swappiness, log trim, package cache, boot wait, CPU governor. Optional AI deep-dive only if you want it.
🆓
Smarter Free-AI Failover
Starts on free providers by priority. When one hits a rate limit, TuxGenie switches clearly to the next free option. Claude is offered only with your explicit yes — never silently.
📦
Reliable Catalog Installs
App and AI tool installs are deterministic across distros — Flatpak fallbacks, native packages where they fit, and fewer “ask the AI to guess the install command” dead ends.
🔄
Resilient Auto-Updates
Every update verifies SHA-256 before install. Downloads retry via curl/wget if needed, and pip is used when that matches how you installed — so [u] doesn’t strand you mid-update.
🛡️
Hardened Null-Safety
Defensive handling of empty AI replies and config edge cases — fewer surprise crashes on real-world provider responses.
⚡
!! Fix Last Command
Type !! after any command fails — TuxGenie instantly diagnoses and fixes it. No copy-pasting error messages.
🐚
tg!! Shell Shortcut
Install with [i] to get tg!! in every terminal. Works in bash and zsh — type it the moment something breaks.
🧠
Cross-Session Memory
Remembers every past fix. Next time you hit a similar problem, TuxGenie shows what solved it last time.
📊
Weekly Health Digest
A compact health report once a week at startup — disk, memory, failed services, pending updates. Run anytime with tuxgenie --digest.
[m]🔔
Background Error Monitor
Installs a systemd service that watches for system errors and fires a desktop notification — so you know to fix things before they get worse.
🛡️
Crash Guard
3 consecutive crashes → automatic rollback to the last known-good version and silent restart. Zero user action needed.
✅
You Approve Every Change
Read-only checks run on their own; anything that changes your system is shown and asks for your OK first. Power users can enable auto-approve in Settings.
[31]🎮
Gaming Setup
One tap to make your PC game-ready — Steam + Proton, the right GPU drivers & Vulkan, GameMode, MangoHud, controllers. Plus free games like SuperTuxKart & 0 A.D.

How TuxGenie compares

There are many AI terminal tools — but they're built either to suggest commands for developers, or to edit code for developers. TuxGenie is built to fix, install, and maintain a whole Linux system, in plain English, for everyone.

Capability TuxGenie AI shell toolsShellGPT · aichat · tgpt AI coding agentsClaude Code · Aider · Codex Built-in OS AIUbuntu 26.10*
Beginner-firstno Linux expertise needed ✓Yes ✗Built for devs ✗Built for devs ~Aims to (preview)
Runs & fixes for youagentic — not just suggestions ✓Yes, iterates ~Runs single cmds ✓Yes ~Planned
Fixes the whole systemWi-Fi, sound, drivers, boot, security ✓Core purpose ✗No ✗Edits code, not the OS ~Planned
One-tap catalogs200 apps · AI tools · games ✓Yes ✗No ✗No ✗No
Layered safetyapproval + hard-block + rollback ✓Full stack ~Approval only ~Approval only ?Unknown
Free, open-source, no telemetry ✓MIT ✓Mostly ~Mixed ~Opt-in
Any distro, in the terminal ✓Any Linux ✓Yes ✓Yes ✗Ubuntu only
✓ Yes ~ Partial / limited ✗ No

Reflects each tool's primary design focus (based on 2026 research across 20+ sources). The coding agents are excellent at what they do — editing code — they're just built for developers, not desktop repair. *Ubuntu's system AI is an opt-in preview announced for 26.10 (Oct 2026), not yet shipping.

Common questions

Everything you need to know before installing.

Your API key is stored locally in ~/.config/tuxgenie/config.json with owner-only permissions (chmod 600) and never leaves your machine. TuxGenie has no backend and collects zero telemetry — nothing is sent anywhere unless you run an AI task, and then only your chosen provider (Anthropic or Google) sees it, never us. Your sudo password is held in memory for the session only — never saved, never sent. Full details on our Privacy & Transparency page.

They all work great. You have four free options — Google Gemini, Groq, SambaNova and OpenRouter (fast Llama models) — all no credit card, perfect for everyday use. Prefer top quality or a confidential machine? Use Claude — Anthropic does not train on API data. One honest note: free tiers (Gemini, Groq, SambaNova, OpenRouter) may use your prompts to improve their products, so pick Claude for sensitive systems. We tell you this at the point you choose, too. Bonus: if you add keys for more than one free provider, TuxGenie can auto-switch between them when one hits its rate limit — so you're never stuck (and it never falls back to paid Claude without asking). See Privacy & Transparency.

It can be completely free. Pick a free tier on first launch — Google Gemini, Groq, SambaNova or OpenRouter — no credit card, nothing to pay. Prefer top quality? Use Claude and you pay Anthropic only for what it uses — typically ~$0.01 per session ($5 lasts months). Either way, simple commands (ls, apt, systemctl…) bypass the AI entirely and cost nothing.

Yes, safely. Read-only checks run on their own, but every command that changes your system is shown and asks for your approval first — [y / n / abort]. Genuinely destructive commands (rm -rf /, disk wipes, fork bombs) are hard-blocked by an argv-aware filter that catches them even when disguised or reordered. Press Ctrl-C anytime, and roll back any session with option [16].

Common commands (apt, systemctl, ls, grep, etc.) run offline instantly — TuxGenie only calls the AI for complex diagnostics and fixes. So basic usage works without internet. Full AI-powered fixes need a connection to reach your chosen AI provider (Gemini, Groq, SambaNova, OpenRouter or Claude).

Any distro running Python 3.8+. Full testing on Ubuntu, Debian, Fedora, Arch, Mint, Pop!_OS, Kali, openSUSE, Raspberry Pi OS, CentOS, and Rocky Linux. The .deb package installs on Debian/Ubuntu-based systems; pip installs everywhere else.

TuxGenie knows your exact system — kernel version, installed packages, running services, disk usage — and acts on it directly. It runs commands, verifies they worked, retries on failure, rolls back changes, and remembers past fixes across sessions. ChatGPT just gives text suggestions.

🐧 Our mission

Built for people, not for profit

TuxGenie is free — and it always will be. We didn't build it to make money. We built it because Linux, the open-source system that quietly runs the world, should be easy enough for anyone to use — not just experts.

We believe in a free and open world: one where the tools that give people opportunity aren't locked behind paywalls, and aren't controlled by any single company. Software like this should belong to everyone.

So this is our contribution — a little genie that helps you fix, learn, and get more from your computer, free, forever. Dedicated to Linus Torvalds, and to everyone who believes technology should stay open.

💛 Free forever 🔓 Open source · MIT 🚫 No tracking 🌍 For everyone

Install on your distro

One curl works on every major distro — or pick yours for the exact command.

💡
TuxGenie is free and open source. On first run, pick your AI — four free options: Google Gemini, Groq, SambaNova or OpenRouter (all free, no credit card), or Claude (best quality, ~$0.01/session). Terminal commands bypass AI entirely and are always free.
⬇ Download Latest Release

Requires Python 3.8+ · Free forever

Free and open source. Always.

MIT licensed. No paywalls, no subscriptions, no tracking. Built by Aspera Technologies and dedicated to Linus Torvalds — creator of the Linux kernel.

⭐ Star on GitHub 🐛 Report Issue
🔑

One-Time Setup

At first run, pick a free key from Google Gemini, Groq, SambaNova or OpenRouter, or Claude (~$0.01/session — $5 lasts months). Paste the key and you're done.

⚡

Smart & Fast

Common commands bypass AI entirely. On Claude, smart routing picks the cheapest model that fits — Haiku first, escalating to Sonnet only when a task needs it.

🔒

Privacy First

No backend. No telemetry. No accounts. Your data goes directly from your machine to the AI provider you chose — never to us. Read the whole thing: it's one file. See our Privacy & Transparency page.

🔄

Verified Auto-Updates

New versions verify a SHA-256 checksum before installing. Downloads retry with curl/wget if needed, and the updater picks .deb or pip to match how you installed. A corrupted download is refused — never installed as root.

🛡️

Crash Guard

If a new version crashes 3 times in a row, TuxGenie automatically rolls back to the last known-good version and restarts. TuxGenie does not have the option of staying broken.

↩

You Stay in Control

Anything that changes your system asks for your OK first. Every command is logged, option [17] rolls back any session, and destructive commands are hard-blocked. Always.

✓ MIT License 🐍 Python 3.8+ ✓ No telemetry 🐧 Any Linux distro ✓ v7.3.1 ⭐ … GitHub stars