✨ 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. 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.
43Built-in Tools
2011-Tap Apps
22AI Tools
GitHub Stars
🆕 Cursor · Windsurf · Zed 🔎 Searchable catalogs ✅ You approve every change 🧠 Cross-session memory 🛡️ Verified auto-updates
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", 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 201 apps and 22 AI tools. Organised the way you actually think.

[77]

App Catalog · 201 apps

Install from 201 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. TuxGenie picks the right install method per distro and 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]🌍
Find Linux App
"What replaces Photoshop / Word / iTunes?" — finds the best alternative.
🛡️ Protect & Recover
[14]🛡️
Security Check
Harden firewall, SSH, and open ports. Know exactly how exposed you are.
[15]💾
Backup Settings
Snapshot all system configs to .tar.gz before making changes.
[16]
Undo Changes
Roll back what TuxGenie did in any previous session instantly.
⚡ Speed & Maintenance
[17]🚀
Performance Boost
Full audit + apply ALL safe speed fixes in one command.
[18]💿
Disk Cleanup
Find space hogs and clean up safely — never delete the wrong thing.
[19]
Speed Up Boot
Find why boot is slow and reduce startup time significantly.
[20]🔋
Battery & Power
Improve battery life and fix overheating on laptops.
[21]⚙️
Manage Services
Optimise startup & running services. Understand what's running.
📊 Inspect
[22]🔩
Hardware Info
Full hardware report — CPU, RAM, GPU, storage, and more.
[23]📈
Running Programs
Tame CPU and memory hogs, kill zombies, restore speed.
[24]📋
Explain Logs
Decode cryptic error messages and system logs in plain English.
⚙️ For Developers
[25]📝
Generate Script
Describe a task → get a working bash script instantly.
[26]
Schedule Task
Cron in plain English — no syntax to remember.
[27]🐳
Docker Help
Container troubleshooting, cleanup, and management simplified.
[28]🔑
SSH Setup
Set up & harden SSH — secure remote access without complexity.
[29]🐙
Git Helper
Fix conflicts, undo commits, understand diffs in plain English.
🚀 New · Power FeaturesRecently added — makes TuxGenie your daily Linux companion
!! 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.
📥
Pipe Mode
Pipe any output directly to TuxGenie: journalctl -xe | tuxgenie explain — instant plain-English explanation of any log.
🛡️
Crash Guard
3 consecutive crashes → automatic rollback to the last known-good version and silent restart. Zero user action needed.
🔄
Verified Auto-Updates
Every update verifies a SHA-256 checksum before installing — a corrupted or tampered download is refused, never installed as root.
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.
🔎
Searchable Catalogs
In the app and AI catalogs, just type a word — "photo", "browser", "backup" — to instantly filter every entry.
[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 optionsGoogle 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

Pick your Linux distribution — get the exact install 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, then apply at startup when sudo is cached. A corrupted or tampered download is refused — never installed.

🛡️

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 [16] rolls back any session, and destructive commands are hard-blocked. Always.

✓ MIT License 🐍 Python 3.8+ ✓ No telemetry 🐧 Any Linux distro ✓ v6.70.0 GitHub stars