Skip to main content

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

Project description

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 install error?

On Linux (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):
    sudo apt install pipx
    pipx ensurepath
    # (Restart your terminal here)
    pipx install jarvis-cli-ck
    
  • Option B: Force User Install:
    pip install jarvis-cli-ck --break-system-packages
    

On Windows (PermissionError or path issues)

If installation fails on Windows or if jarvis command is not recognized after installation:

  • Option A: Run as Administrator: Open Command Prompt or PowerShell as Administrator and run:
    pip install --upgrade jarvis-cli-ck
    
  • Option B: User-only install:
    pip install --upgrade --user jarvis-cli-ck
    
  • Option C: Use isolated environment:
    python -m venv %USERPROFILE%\.jarvis-env
    %USERPROFILE%\.jarvis-env\Scripts\pip install jarvis-cli-ck
    # To run: %USERPROFILE%\.jarvis-env\Scripts\jarvis
    

🖥️ 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jarvis_cli_ck-1.3.9.tar.gz (73.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jarvis_cli_ck-1.3.9-py3-none-any.whl (71.9 kB view details)

Uploaded Python 3

File details

Details for the file jarvis_cli_ck-1.3.9.tar.gz.

File metadata

  • Download URL: jarvis_cli_ck-1.3.9.tar.gz
  • Upload date:
  • Size: 73.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for jarvis_cli_ck-1.3.9.tar.gz
Algorithm Hash digest
SHA256 7fb574ad5435474c242d1444e5917c338865dbe5b405f581656f783d3b92f105
MD5 272f6f9f2b36272c5b8edac7cfcf770c
BLAKE2b-256 00a073ac78db438250b8c5a16b349b29b37cd86408f14e676a9d066ad3b5ddfc

See more details on using hashes here.

File details

Details for the file jarvis_cli_ck-1.3.9-py3-none-any.whl.

File metadata

  • Download URL: jarvis_cli_ck-1.3.9-py3-none-any.whl
  • Upload date:
  • Size: 71.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for jarvis_cli_ck-1.3.9-py3-none-any.whl
Algorithm Hash digest
SHA256 f90b16ed9d5d9a7ac6abf3ab1b3d904fdc893e73fe43c59a1f59bc296d795c99
MD5 e703ff62c5084ac55cc7dcbb93bf72f9
BLAKE2b-256 1f52a5cd69afec4512dad41481fa425a56c76e0230288de6f4429ecba0e86bf6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page