Skip to content
MuhammadHamdan35Public

About

An AI-powered Electron desktop assistant integrating a local LLM (Ollama/Llama 3) for conversational queries. Powered by a custom Node.js backend, it features real-time system hardware monitoring, live news aggregation, and financial market data feeds.

Topics

Resources

Stars

2 stars

Watchers

2 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

Repository files navigation

📌 Overview

JARVIS OS is a highly advanced, Electron-based desktop artificial intelligence assistant. Designed with a tactical, Iron Man-inspired Heads-Up Display (HUD), it integrates a local Large Language Model (LLM) to handle conversational queries securely and offline. Beyond AI chat, the application functions as a comprehensive system and intelligence dashboard, featuring real-time system hardware monitoring, live news aggregation, climate data, and financial market data feeds.

🖥️ System Interface

JARVIS OS Main Tactical HUD

The core tactical dashboard featuring real-time system metrics, AI command interface, global threat mapping, and live market/climate telemetry.


JARVIS OS Boot Sequence

Marvel-inspired initialization sequence featuring dynamic topology mapping and a personalized Text-to-Speech (TTS) greeting upon boot completion.

✨ Core Features

  • Local AI Engine: Integrates with Ollama running the llama3.2:1b model for private, offline, and concise AI query processing. Includes hybrid routing to combine web search results with LLM outputs.
  • Hardware Telemetry: Real-time monitoring of CPU load, RAM allocation, and Network I/O traffic using the systeminformation package.
  • Global Intelligence Network: Features a dynamic 3D orthographic globe built with D3.js and TopoJSON, visualizing simulated network traffic and global nodes.
  • Financial & Environmental Data: Live fetching of BTC/USD and GBP/PKR exchange rates with historical sparkline charts (Chart.js), alongside live weather telemetry for major global cities.
  • Voice Integration: Built-in Web Speech API integration for hands-free microphone input and Text-to-Speech (TTS) auditory responses.
  • Simulated Cybersecurity Firewall: A live firewall event log interface simulating threat detection, IP blocks, and sandbox quarantines.

📋 Prerequisites

Before setting up JARVIS OS, ensure you have the following core technologies installed on your environment:

  • Node.js: (v18.0.0 or higher) Required to run the JavaScript backend and package manager.
  • Electron: The desktop application framework (installed via npm during setup).
  • Ollama: Must be installed locally to host and serve the local Llama AI model.
  • Llama 3.2 Model: The lightweight 1B parameter model (llama3.2:1b).
  • Git: Command-line interface for cloning the repository.

🛠️ Tech Stack & Architecture

Frontend UI/UX:

  • HTML5 / CSS3 / Vanilla JavaScript
  • D3.js & TopoJSON: For the interactive 3D global threat map
  • Chart.js: For financial market sparklines

Backend & Core:

  • Node.js / Electron: Application framework and operating system integration
  • Ollama API: Local LLM hosting and generation
  • Axios: For rapid API requests (Binance, CoinDesk, Open-Meteo, Reddit)
  • Duck-Duck-Scrape: For the hybrid AI web-search functionality

🚀 Installation & Setup

Step 1: Initialize the Local AI Model

Open your terminal and pull the required Llama model to ensure JARVIS can process queries offline:

ollama run llama3.2:1b

Step 2: Clone & Install Dependencies

Clone the repository and install the project dependencies (this will install Electron and other required Node packages):

# Clone the repository
git clone https://github.com/MuhammadHamdan35/jarvis-os.git

# Navigate into the project directory
cd jarvis-os

# Install required packages (including Electron)
npm install

Step 3: Launch JARVIS OS

Start the Electron tactical console:

npm start

🏗️ Build for Production

To package the application into a standalone executable (.exe) for Windows, run:

npm run build

For a portable version:

npm run build-portable

👨‍💻 Author

Muhammad Hamdan

  • BS Cyber Security Undergraduate
  • Certified LLM Security Professional (CLLMSP) & AI Security / Governance
  • Specializing in applied cryptography, machine learning malware detection, and AI-driven security systems.

About

An AI-powered Electron desktop assistant integrating a local LLM (Ollama/Llama 3) for conversational queries. Powered by a custom Node.js backend, it features real-time system hardware monitoring, live news aggregation, and financial market data feeds.

Topics

Resources

Stars

2 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages