jarvis-cli-ck 1.0.1

Jarvis — A sharp, friendly terminal AI assistant. Cross-platform CLI powered by NVIDIA NIM & Ollama.

Jarvis CLI — jarvis-cli-ck

A sharp, friendly AI partner built into your terminal. Powered by NVIDIA NIM cloud models & local Ollama. Works on Linux, macOS, and Windows.

---

⚡ Install (Any OS)

pip install jarvis-cli-ck

Then just run:

jarvis

⚠️ Got an externally-managed-environment error?

On modern Linux distributions (like Ubuntu 23.04+, Debian, Fedora), system-wide pip installs are blocked by default. You can resolve this using one of these options:

Option A: Install via pipx (Recommended)

pipx automatically manages isolated environments for command-line tools.

sudo apt install pipx
pipx ensurepath
# (Restart your terminal here)
pipx install jarvis-cli-ck

Option B: Bypass warning

If you want to install it anyway directly in your user environment:

pip install jarvis-cli-ck --break-system-packages

---

🖥️ OS Support

OS	Install	Works?
Ubuntu / Debian	pip install jarvis-cli-ck	✅
Fedora / Arch Linux	pip install jarvis-cli-ck	✅
macOS	pip install jarvis-cli-ck	✅
Windows 10/11	pip install jarvis-cli-ck	✅
Any OS with Python 3.10+	pip install jarvis-cli-ck	✅

---

📦 One-Line Installers (Alternative)

Linux / macOS

curl -sSL https://raw.githubusercontent.com/karthik/jarvis-cli/main/install.sh | bash

Windows (PowerShell)

pip install jarvis-cli-ck

Or double-click install.bat from the downloaded release.

---

🚀 Features

• 💬 Smart Chat — Short, friendly, professional replies. Matches your energy.
• 🌐 Live News — Fetches real-time headlines. Supports regional queries (e.g., "news in Tamilnadu").
• 🕐 Time & Date — Instant time, date, calendar info.
• 🖥️ System Diagnostics — Live CPU, RAM, disk, battery stats via psutil.
• 🔐 Security Scanner — Built-in heuristic scanner, no ClamAV needed.
• 📁 File Manager — Find, open, and manage files via chat.
• 🗺️ Maps & Directions — Ask for directions or locations.
• 💻 Code Assistant — Write, debug, and generate code.
• 🌐 Web Developer — Generate HTML/CSS/JS apps from a description.
• ⚡ Command Runner — Safely execute shell commands on any OS.
• 🌍 Multi-language — English, Tamil, Tanglish support.

---

📁 Chat History

Every conversation is automatically saved locally — no database needed.

your-folder/
└── jarvis-chat-history/
    ├── 2026-07-04_16-35-42.jsonl   ← this session
    └── 2026-07-03_10-12-00.jsonl   ← previous session

Each file is plain JSONL — one message per line, human-readable.

---

⚙️ Configuration (Optional)

To use NVIDIA NIM cloud models, create ~/.jarvis/config.yaml:

jarvis:
  llm_model: phi3:mini   # Local Ollama model (optional)

apis:
  nvidia_nim:
    deepseek_v4_flash: YOUR_NIM_API_KEY
    llama_3_2_11b_vision_instruct: YOUR_NIM_API_KEY

Get a free NVIDIA NIM API key at: https://build.nvidia.com/

Without a config file, Jarvis works with a local Ollama instance.

---

🔧 Requirements

• Python 3.10+
• pip (comes with Python)
• Internet connection (for cloud LLM models)
• Optional: Ollama for fully local/offline operation

---

📄 License

MIT License — free to use, modify, and distribute.