// Open-Source AI Assistant

J.A.R.V.I.S.

Explore Features ★ View on GitHub

Built different.
By design.

Not another chatbot. JARVIS is a fully local, voice-activated AI system with a cinematic HUD — running on your machine, on your terms.

🎙️

Wake Word Activation

Just say "Jarvis" and start talking. No clicks, no typing — it listens the moment you speak.

🌐

Holographic HUD

A stunning glassmorphism overlay rendered by Electron — looks exactly like the movies, runs on your desktop.

Dual AI Engine

Switch between Groq's ultra-fast inference or Google Gemini's massive context window — or run both simultaneously.

🛑

Instant Interrupt

Click the JARVIS core at any moment to instantly stop a response mid-sentence. Full control, always.

🖥️

Cross-Platform

Windows, macOS, and Linux supported out of the box. One codebase, every machine.

🔓

Fully Open Source

MIT licensed. Fork it, mod it, break it, rebuild it. The source is yours — no black boxes.

Pick your AI engine.

JARVIS can run on free cloud API keys or a local LM Studio model on your own machine.

"Give me a few hours. I'll have something better figured out." — Tony Stark

Groq API

Blazing fast inference using custom LPU hardware. Get responses in under a second, completely free on the standard tier.

→ Get Groq API Key
⭐ Best context window

Google Gemini API

Massive context window and deep multi-turn reasoning. Ideal for long conversations and complex tasks. Free via AI Studio.

→ Get Gemini API Key
⚠️ Highly Experimental

LM Studio (Not Recommended)

Run JARVIS through a local OpenAI-compatible server. Highly experimental and not recommended for daily use. Load a model in LM Studio, start the server, and set LM_STUDIO_ENABLED=true.

→ Get LM Studio

// Gemini is used first otherwise Groq is prioritized over LM Studio if enabled

Up and running
in under 5 minutes.

Choose your platform and follow the steps. A single script handles everything else.

⚠️

Pre-built installer under maintenance — The .exe installer and .zip portable are being updated. For now, the script install below takes less than 5 minutes and works on any machine.

⚠️

Development build warning — JARVIS v0.4 is still under active development. Some features may have bugs while the systems are being upgraded.

01

Get the source code

Option A — Clone with Git:

git clone https://github.com/Aetex/J.A.R.V.I.S.-AI-Assistant.git
cd J.A.R.V.I.S.-AI-Assistant
📦

Option B: Download ZIP archive — extract the folder, open it.

02

Run the installer

Double-click install_windows.bat and wait for "INSTALLATION COMPLETE!". It sets up your virtual environment, automatically creates the configuration files, and installs all dependencies.

03

Launch JARVIS

Double-click launch_jarvis.bat. Once the holographic HUD boots up, you can paste and configure your Groq or Gemini API keys directly inside the settings panel.

01

Get the source code

Option A — Clone with Git:

git clone https://github.com/Aetex/J.A.R.V.I.S.-AI-Assistant.git
cd J.A.R.V.I.S.-AI-Assistant
📦

Option B: Download ZIP archive — extract and open in terminal.

02

Run the installer

sh install_mac.sh
03

Launch JARVIS

Launch the HUD, then paste and configure your API keys directly inside the settings panel:

sh launch_jarvis.sh
01

Clone the repository

git clone https://github.com/Aetex/J.A.R.V.I.S.-AI-Assistant.git
cd J.A.R.V.I.S.-AI-Assistant
02

Run the installer

sh install_linux.sh
03

Launch JARVIS

Launch the HUD, then paste and configure your API keys directly inside the settings panel:

sh launch_jarvis.sh

Talk to it.
It listens.

JARVIS is designed to feel natural. No menus, no configuration panels — just your voice.

"JARVIS, it's time for a little upgrade." — Tony Stark
// activate

Wake Word

Say "Jarvis" to get its attention, then speak your command naturally. No push-to-talk button required.

// compact mode

Mini HUD

Hit the [MINI] button to shrink the HUD into a slim overlay. Perfect for multitasking without losing JARVIS.

// stop output

Interrupt Anytime

Click the central JARVIS core orb at any time to immediately cut off a long response mid-sentence.

// developer mode

Live Debug Logs

Say "Jarvis, enter debugging mode" to see real-time system logs — useful for tweaking or troubleshooting.

Something not
working?

Here are the most common issues and how to fix them in under a minute.

"I'm going to need a little time to work on that." — Tony Stark

Microphone not detected

Go to your OS sound settings and set your microphone as the default input device. JARVIS uses the system default — no manual device selection yet.

Backend fails to start / API error

Make sure you have configured at least one key (Groq or Google Gemini) inside the settings panel in the HUD, and that there are no invalid characters or trailing spaces.

HUD doesn't open / blank window

Run npm install inside the ui/ folder first. Electron dependencies must be installed separately from the Python backend.

PyAudio install fails on Linux

Re-run sh install_linux.sh. The installer now detects your distro and installs the required PyAudio and PortAudio system packages automatically.