Skip to content

kian-irani/Jarvis-android

🤖 JARVIS

Distributed AI assistant for Android — Iron Man-style HUD launcher

🇮🇷 نسخه فارسی پایین صفحه

Build APK Version Platform AI License: MIT Latest Release Download APK Donate TRC20


🎯 What is this?

JARVIS is a distributed AI assistant ecosystem with three components:

  • 📱 Android Launcher — Iron Man HUD-style home screen
  • 🧠 Brain Server — FastAPI backend with LLM integration
  • 🔗 Node Mesh — every device on your network is a Node

The AI brain runs LLaMA 3.3 70B via Groq (free tier), and any device on your network can talk to it through the Node Agent. Your Android phone becomes a voice-activated assistant that knows about your home, your servers, your schedule.


🏗️ Architecture

📱 JARVIS Android (Kotlin)
    ↓  HTTPS + WebSocket
🧠 Brain Server (Python/FastAPI on VPS)
    ↓  Groq API
🤖 LLaMA 3.3 70B (free)

   ↑
🔗 Node Agents (Python)
   └── Home server, NAS, IoT devices, etc.

✨ Features

Android Launcher

  • 🎨 HUD overlay — Iron Man-inspired widget showing system stats, calendar, weather, AI suggestions
  • 🎤 Voice activation — "Hey JARVIS"
  • 📊 Quick info cards — battery, network, time, smart home
  • 🎯 App launcher with AI-suggested apps based on context

Brain Server

  • 🧠 LLM integration — LLaMA 3.3 70B / Mixtral / Gemma via Groq
  • 💬 Multi-turn conversations with session memory
  • 🔌 Plugin system — extend with custom commands
  • 📡 WebSocket for real-time push to Android
  • 🔐 Per-user auth with token-based access

Node Agents

  • 🐍 Lightweight Python (~30MB RAM)
  • 🔗 Auto-discovery on local network
  • 📊 System metrics reported to Brain
  • 🎛️ Remote command execution (with security restrictions)

📦 Components

Folder Description
android/ Kotlin Android launcher (Jetpack Compose)
app/ Legacy Android module
brain/ FastAPI brain server (deploy on VPS)
node-agent/ Python agent for non-Android devices
dashboard.html Web dashboard for brain monitoring
docker-compose.yml One-shot deploy for brain + dashboard

🚀 Quick Start

Brain Server (VPS or local)

git clone https://github.com/KIAN-IRANI/Jarvis-android.git
cd Jarvis-android
cp .env.example .env
# Edit .env with your Groq API key and admin token
docker-compose up -d

Brain will be available at http://localhost:8000.

Android App

Download latest APK from Releases → install → configure Brain URL.

Node Agent (other devices)

pip install -r node-agent/requirements.txt
python node-agent/agent.py --brain http://your-brain:8000

🗺️ Roadmap

See ROADMAP.md for detailed plans. Highlights:

  • Local LLM fallback (Ollama support)
  • Voice synthesis (offline TTS)
  • Custom wake-word training
  • Smart home integrations (Home Assistant, Tasmota)
  • Multi-user with role-based access

🛠️ Tech Stack

  • Android: Kotlin + Jetpack Compose
  • Brain: Python 3.11+ + FastAPI + WebSocket
  • AI: Groq API (LLaMA 3.3 70B default, configurable)
  • Storage: SQLite (brain memory)
  • Deploy: Docker + docker-compose
  • Build: Gradle 8 (Android), uv (Python)

🤝 Contributing

PRs welcome! Especially:

  • 🌍 Translations
  • 🎨 UI/HUD widgets
  • 🔌 New plugin integrations
  • 📖 Documentation improvements

See CONTRIBUTING.md (coming soon).


💝 Support this project

If you find this project useful, please consider supporting via Tron TRC20:

TEVuoZ7574341zbc8pc5jrrBrgqGGMys5q

(Accepts USDT, USDC, TRX. See DONATE.md for full details.)


🆘 Support & Community


📄 License

MIT — see LICENSE


معرفی فارسی

🤖 JARVIS — دستیار هوشمند توزیع‌شده

یه سیستم اکوسیستم AI با ۳ بخش:

  • 📱 لانچر اندروید — رابط کاربری HUD سبک آیرون مَن
  • 🧠 Brain Server — سرور FastAPI با هوش مصنوعی
  • 🔗 Node Mesh — هر دستگاه شبکه‌ت یه Node

موتور AI با LLaMA 3.3 70B از Groq (رایگان) کار می‌کنه. گوشی اندرویدت می‌شه یه دستیار صوتی که از خونه، سرورها، و برنامه‌ت خبر داره.

🏗️ معماری

📱 JARVIS Android (Kotlin)
    ↓  HTTPS + WebSocket
🧠 Brain Server (Python/FastAPI روی VPS)
    ↓  Groq API
🤖 LLaMA 3.3 70B (رایگان)

✨ ویژگی‌ها

  • 🎨 HUD overlay سبک آیرون من — آمار سیستم، تقویم، آب‌وهوا
  • 🎤 فعال‌سازی صوتی — «هی جارویس»
  • 🧠 LLaMA 3.3 70B از Groq (رایگان)
  • 🔗 Node Mesh — همه دستگاه‌های شبکه قابل کنترل
  • 🐍 Node Agent سبک (~۳۰ مگ RAM)

🚀 شروع سریع

git clone https://github.com/KIAN-IRANI/Jarvis-android.git
cd Jarvis-android
cp .env.example .env
# .env رو با کلید Groq و توکن admin ویرایش کن
docker-compose up -d

اپلیکیشن اندرویدش رو از Releases دانلود کن.

💬 ارتباط

💝 حمایت

ترون TRC20 (USDT/USDC/TRX):

TEVuoZ7574341zbc8pc5jrrBrgqGGMys5q

جزئیات: DONATE.md


Star if you like the idea!

About

🤖 JARVIS — distributed AI assistant for Android. Iron Man-style HUD launcher with LLM backend.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors