Metadata-Version: 2.4
Name: jarvis-cli-ck
Version: 1.0.1
Summary: Jarvis — A sharp, friendly terminal AI assistant. Cross-platform CLI powered by NVIDIA NIM & Ollama.
License: MIT
Project-URL: Homepage, https://github.com/karthik/jarvis-cli
Project-URL: Bug Tracker, https://github.com/karthik/jarvis-cli/issues
Keywords: ai,cli,assistant,terminal,llm,jarvis,nvidia,ollama
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Terminals
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: ollama>=0.1.8
Requires-Dist: requests>=2.31.0
Requires-Dist: feedparser>=6.0.10
Requires-Dist: psutil>=5.9.6
Requires-Dist: google-auth-oauthlib>=1.1.0
Requires-Dist: google-api-python-client>=2.108.0
Requires-Dist: icalendar>=5.0.11
Requires-Dist: dateparser>=1.2.0
Requires-Dist: fuzzywuzzy>=0.18.0
Requires-Dist: python-Levenshtein>=0.23.0

# 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)

```bash
pip install jarvis-cli-ck
```

Then just run:

```bash
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.
```bash
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:
```bash
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
```bash
curl -sSL https://raw.githubusercontent.com/karthik/jarvis-cli/main/install.sh | bash
```

### Windows (PowerShell)
```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`:

```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](https://ollama.com/) for fully local/offline operation

---

## 📄 License

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