⚡ HYPER CLI — Ultra-Fast Cyberpunk AI Terminal Assistant

High-performance, 100% Free AI streaming CLI engineered for developers with rich cyberpunk visuals, zero-drift terminal menus, and multi-model intelligence.

🚀 Quick Start & Installation

Option 1: Global Installation / Update to Latest Version (Recommended)

Install or update to the latest version on your Mac, Linux, or Windows machine:

npm install -g hyper-ai-cli@latest

Once installed, launch HYPER CLI anywhere by running:

hyper

Option 2: Instant Run Latest Version via npx (No Install Required)

Run the latest version instantly without installing globally:

npx hyper-ai-cli@latest

⚡ Complete Commands Reference Guide

Inside HYPER CLI, type / anytime to pull up the interactive command suggestions box.

| Command | Description | | :--- | :--- | | hyper or npx hyper-ai-cli | Launch the interactive HYPER CLI session | | /mode | Switch operating mode (💬 Chat, 🎨 Image Generation, ⚡ Coding & Dev) | | /model | Switch models (⚡ HYPER-3B Local 6.2GB GGUF, Auto Router, NVIDIA Nemotron 9B, OpenAI GPT-OSS 20B, Cohere North Mini Code) | | /theme | Switch terminal theme (🔴 Red-Shift, 🟢 Matrix, 🟣 Synthwave, ⚪ Obsidian) |

⚡ Local AI Engine: HYPER-3B (6.2 GB GGUF)

hyper-ai-cli supports 100% Local Offline Execution using your custom fine-tuned model:

• Model Engine: hassanhussain7913/hyper
• Download Size: 6.2 GB (F16 GGUF) / 3.5 GB (Q4_K_M GGUF)
• Speed: 100+ Tokens / Second (Native C++ Metal/CUDA GPU Acceleration)

🚀 1. IF YOU HAVE OLLAMA:

Run directly in any terminal:

ollama run hassanhussain7913/hyper

🚀 2. WITHOUT OLLAMA (Direct C++ Metal Engine / Python / Hugging Face):

Option A: Direct High-Speed C++ Metal Engine (No Ollama Required)

./llama-cli -m hyper-3b-f16.gguf -p "Who created you?"

Option B: Python Transformers (Hugging Face Hub)

from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "m-hasssssan/hyper-3b-llm"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype="auto", device_map="auto")

Option C: Download Direct GGUF File from Hugging Face

huggingface-cli download m-hasssssan/hyper-3b-llm hyper-3b-f16.gguf --local-dir .

• Official Ollama Model Page: ollama.com/hassanhussain7913/hyper
• Hugging Face Model Hub: huggingface.co/m-hasssssan/hyper-3b-llm | /copy | Copy the last AI response directly to your system clipboard | | /login | Launch authentication wizard to configure OpenRouter or Google Gemini keys | | /logout | Wipe all saved API keys and reset local credentials store | | /history | View persistent conversation memory (last 20 messages) | | /clear | Clear persistent conversation memory | | /effort | Display live developer velocity, line stats, and engine efficiency | | /skills | Display active AI capabilities and synthesis modules | | /plugins | List active workspace extensions | | /system | Print system diagnostics, Node version, and connection latencies | | /help | Display interactive help manual | | exit | Quit HYPER CLI session |

💡 Operating Modes

1. 💬 CHAT MODE: Ultra-fast general conversation, reasoning, and synthesis.
2. 🎨 IMAGE GENERATION: Synthesizes AI artwork on-the-fly and saves .png images directly to your Desktop.
3. ⚡ CODING MODE: High-performance code generation, refactoring, and debugging engine.

🔑 Authentication & 100% Free API Platforms

HYPER CLI supports two 100% free AI providers:

• OpenRouter Free Models: Connect key from openrouter.ai/keys.
• Google Gemini Direct API: Connect key from aistudio.google.com/app/apikey (1,500 free requests/day).

Run /login inside the terminal prompt anytime to configure or switch your credentials!

🛠️ Development & Local Build

git clone https://github.com/m-hasssssan/hyper-cli.git
cd hyper-cli
npm install
npm run build

📄 License

MIT License. Free and open source for all developers.