Advanced Setup Dashboard

A detailed, step-by-step setup UI for the repository jarvis-omega-cloud-agent. This page helps users configure dependencies, secrets, runtime modes, and safe GitHub deployment.

Public-repo safe Cross-platform instructions Interactive command copy Progress tracking

View Source Code on GitHub Donate

Main Entry

jarvis_ai.py

Source Folder

src/

Config Folder

config/

Docs Folder

docs/

1) Quick Start Path

Use this minimum path for first successful launch.

Clone repository and open project folder.
Copy config/zshrc.secrets.example to ~/.zshrc.secrets.
Fill TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID with your own values.
Run python3 jarvis_ai.py --status and verify keys are loaded.
Launch with --text or --telegram-bot.

Quick start commands

git clone https://github.com/Balajitechlabs/jarvis-omega-cloud-agent.git
cd jarvis-omega-cloud-agent
cp config/zshrc.secrets.example ~/.zshrc.secrets
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip
python3 jarvis_ai.py --status
python3 jarvis_ai.py --text

Rotate any old keys that were exposed before publishing publicly.

Only commit template files. Never commit ~/.zshrc.secrets.

2) OS-Specific Installation

Optimized path for Apple Silicon and zsh workflow.

Install dependencies

brew install python git jq curl wget
brew install imagesnap gitleaks ollama
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip

Ubuntu/Debian shown below. Fedora users can replace apt with dnf.

Install dependencies

sudo apt update
sudo apt install -y python3 python3-venv python3-pip git curl jq
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip

Use WSL2 for full command compatibility. Native PowerShell has partial support.

PowerShell quick path

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
py -3 -m pip install --upgrade pip
py -3 jarvis_ai.py --status

3) Environment Variable Matrix

Set required values first. Optional values unlock more providers/features.

Variable	Required?	Purpose	Example Placeholder
TELEGRAM_BOT_TOKEN	Required	Telegram bot authentication	ENTER_YOUR_TELEGRAM_BOT_TOKEN
TELEGRAM_CHAT_ID	Required	Authorized chat for bot commands	ENTER_YOUR_TELEGRAM_CHAT_ID
OLLAMA_API_KEY	Optional	Cloud Ollama inference key	ENTER_YOUR_OLLAMA_API_KEY
NVIDIA_CHAT_KEY	Optional	NVIDIA NIM chat access	ENTER_YOUR_NVIDIA_CHAT_KEY
GITHUB_TOKEN	Optional	GitHub automation flows	ENTER_YOUR_GITHUB_TOKEN

Create local secrets file

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

4) Runtime Modes

Main modes

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

For daemon style:

Background run

nohup python3 jarvis_ai.py --telegram-bot > ~/jarvis_bot.log 2>&1 &
tail -f ~/jarvis_bot.log
pkill -f "jarvis_ai.py --telegram-bot"

Architecture Snapshot

Layer	File	Role
Launcher	jarvis_ai.py	Root entry for src runtime
Core Agent	src/jarvis_ai.py	AI engines, system ops, bot logic
Bot Runner	src/telegram_bot.py	Telegram daemon bootstrap
Config	config/zshrc.secrets.example	Safe secrets template
Docs	docs/README.*.md	OS-specific setup guides

5) Troubleshooting Center

Telegram bot says not configured

Verify TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in ~/.zshrc.secrets, then run source ~/.zshrc.

Permission or command not found errors

Confirm python3 exists, activate .venv, and check PATH. On macOS run brew doctor if dependency installs fail.

Provider auth errors 401/403

Token may be expired/revoked/wrong scope. Regenerate key and update ~/.zshrc.secrets.

Push blocked by secret scans

Remove hardcoded values from tracked files. Keep only placeholders in template files.

6) Public Repo Deploy Checklist

Safe push commands

git status
git add .
git commit -m "docs: advanced setup dashboard"
git push origin main

Main README macOS Guide Linux Guide Windows Guide