Metadata-Version: 2.4
Name: jarvis-cli-ck
Version: 1.3.3
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 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)**:
  ```bash
  sudo apt install pipx
  pipx ensurepath
  # (Restart your terminal here)
  pipx install jarvis-cli-ck
  ```
- **Option B: Force User Install**:
  ```bash
  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:
  ```cmd
  pip install --upgrade jarvis-cli-ck
  ```
- **Option B: User-only install**:
  ```cmd
  pip install --upgrade --user jarvis-cli-ck
  ```
- **Option C: Use isolated environment**:
  ```cmd
  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
```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.
