✨ Open Source · MIT · Powered by 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.

⚡
Needs an Anthropic API key — sign-up is free, ~$0.01 per session. Top up $5 once and it lasts months. Get a key →
🐧 Install Free ⭐ Star on GitHub
31Built-in Tools
…GitHub Stars
AnyLinux Distro
🆕 !! fix-last-command 🆕 tg!! shell shortcut 🆕 Silent auto-updates 🛡️ Crash guard 🧠 Cross-session memory
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 32 built-in tools land on any Linux distro immediately.

2

Add your Claude key

Paste an Anthropic API key from console.anthropic.com. Sign-up is free; usage is metered (a few cents per session). Change the key 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.

32 built-in tools, one terminal

Everything you need to manage, fix, and optimise Linux — organised the way you actually think.

[77]

App Catalog

Pick from 30 popular Linux apps by number. Multi-select with ranges like 1-5 or 1,3,7 — TuxGenie picks the right install method per distro.

BraveChromeVLC SpotifySlackDiscord VS CodeDockerGIMP Steam+20 more
[99]

AI Tools

Install Ollama, Claude Code, Whisper, ChatGPT and more. The Local AI Starter Pack sets up Ollama + Open WebUI + llama3.2:3b in one tap. Zero to local AI.

OllamaClaude CodeOpen WebUI JanLM StudioAider Continue.devWhisperChatGPT
🔧 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.
🔄
Silent Auto-Updates
Updates apply automatically at startup when sudo credentials are cached. No prompts, no u command needed.

Common questions

Everything you need to know before installing.

Your API key is stored locally in ~/.config/tuxgenie/config.json and never leaves your machine. Requests go directly from your computer to Anthropic's servers — TuxGenie itself has no backend and collects zero telemetry.

TuxGenie is free. You only pay Anthropic for the Claude API calls it makes — typically ~$0.01 per session. A $5 top-up lasts most users several months. Simple commands (ls, cd, apt, systemctl) bypass Claude entirely and cost nothing.

Every command is shown to you before it runs. Destructive operations (rm -rf, format, wipe) are blocked by default. You're always in control — press Ctrl-C at any time to stop. All changes are logged so you can roll back with option [16].

Common commands (apt, systemctl, ls, grep, etc.) run offline instantly — TuxGenie only calls Claude for complex diagnostics and fixes. So basic usage works without internet. Full AI-powered fixes need a connection to reach Anthropic's API.

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.

Install on your distro

Pick your Linux distribution — get the exact install command.

💡
TuxGenie is free and open source. Powered by Claude — paste a key from console.anthropic.com on first run (sign-up is free, ~$0.01 per 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

Paste an Anthropic API key at first run and you're done. Sign-up is free; ~$0.01 per session. Top up $5 once and it lasts months.

⚡

Smart & Fast

Common commands bypass AI entirely. Smart routing uses the cheapest model that handles the task — Claude Haiku by default, escalates to Sonnet only when needed.

🔒

Privacy First

No backend. No telemetry. Your data goes directly from your machine to Anthropic's API. TuxGenie is fully open source — read every line at GitHub.

🔄

Silent Auto-Updates

New versions apply automatically at startup when sudo credentials are cached. No prompts needed. Falls back to a one-tap confirmation if sudo isn't available.

🛡️

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.

↩

Always Reversible

Every command TuxGenie runs is logged. Option [16] rolls back any session. Destructive operations are blocked. You stay in control — always.

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