lzjever

lzjever / air-gapped

Public

Portable Codex CLI + vLLM for air-gapped use

68
1
100% credibility
Found Mar 02, 2026 at 49 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

A portable folder that runs an offline AI assistant compatible with Codex CLI for generating operations commands and configurations in air-gapped environments.

How It Works

1
🔍 Discover offline AI helper

You hear about a handy folder that brings an AI ops expert into secure rooms without any internet or cloud connections.

2
💻 Prepare on your regular computer

On a computer with internet, you run a simple setup script once to download everything needed into one folder.

3
📦 Copy to secure machine

Transfer the entire ready-to-go folder to your air-gapped computer using approved media, feeling secure and prepared.

4
▶️ Start the AI brain

Open a terminal in the folder and launch the AI helper, watching it wake up and get ready to assist.

5
💬 Ask for ops help

In a new terminal, tell it what you need like 'show unhealthy pods' and it generates commands instantly.

✅ Work offline with confidence

You troubleshoot, deploy, and manage systems smoothly with your private AI expert, no compromises or connections needed.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 49 to 68 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is air-gapped?

This Shell-based project packs a portable Codex CLI agent powered by llama.cpp and a 3B GGUF model into one folder for air-gapped environments. Bootstrap it once on a connected machine to grab the model and binaries, then copy the whole kit to an air-gapped computer or network—no internet needed after that. It spins up an OpenAI-compatible API locally, letting you run tasks like "generate a Kubernetes Deployment YAML" fully offline, solving the pain of memorizing complex ops commands in secure rooms.

Why is it gaining traction?

Unlike cloud-dependent AI tools, it delivers a true one-folder air-gapped backup: prepare on any machine, USB it into air-gapped systems, and execute via simple CLI commands like start server, run codex exec "task". Developers dig the zero-compromise portability—works on Linux x64 CPU without GPU, supports custom GGUF models, and mimics Codex exactly for ops scripting. It's a github portable apps gem for offline GitHub CLI vibes in restricted setups.

Who should use this?

DevOps engineers in air-gapped networks generating kubectl commands or YAML configs without docs. Security ops teams needing an air-gapped system AI for troubleshooting deployments in classified environments. Anyone managing air-gapped wallets or air-gapped Github workflows who wants portable Python-like scripting offline.

Verdict

Grab it if you're in high-security ops—solid docs and tests make setup straightforward despite 34 stars and 1.0% credibility score signaling early maturity. Test in a sandbox first; it's functional but lacks broad validation for production air-gapped deutsch or windows use.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.