# Linux Setup Guide

Use this guide for Ubuntu/Debian/Fedora-based environments.

## 1) System Packages

Ubuntu/Debian:
- sudo apt update
- sudo apt install -y python3 python3-venv python3-pip git curl jq

Fedora:
- sudo dnf install -y python3 python3-pip git curl jq

Optional utilities:
- gitleaks
- adb / android-tools
- ollama

## 2) Python Environment

- python3 -m venv .venv
- source .venv/bin/activate
- python3 -m pip install --upgrade pip

Optional voice libs may vary by distro and audio stack.

## 3) Secrets Setup

- cp config/zshrc.secrets.example ~/.zshrc.secrets
- nano ~/.zshrc.secrets

Fill required keys:
- TELEGRAM_BOT_TOKEN
- TELEGRAM_CHAT_ID

Load env in shell:
- source ~/.zshrc.secrets

## 4) Run

- python3 jarvis_ai.py --status
- python3 jarvis_ai.py --text
- python3 jarvis_ai.py --telegram-bot

## 5) Notes for Linux

- macOS-only features (osascript, say, imagesnap) may not work.
- Replace those features with Linux alternatives if needed.
- Keep platform conditionals if you contribute cross-platform patches.