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.
The core tactical dashboard featuring real-time system metrics, AI command interface, global threat mapping, and live market/climate telemetry.
Marvel-inspired initialization sequence featuring dynamic topology mapping and a personalized Text-to-Speech (TTS) greeting upon boot completion.
- Local AI Engine: Integrates with Ollama running the
llama3.2:1bmodel 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
systeminformationpackage. - 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.
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.
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
Open your terminal and pull the required Llama model to ensure JARVIS can process queries offline:
ollama run llama3.2:1bClone 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 installStart the Electron tactical console:
npm startTo package the application into a standalone executable (.exe) for Windows, run:
npm run buildFor a portable version:
npm run build-portableMuhammad 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.