Productivity - JARVIS HUD Assistant

Stark-style Flutter desktop assistant with voice control, text chat, local LLM responses, memory context, and command automation.

Features

• Stark-inspired HUD interface with interactive panels.
• Voice input (speech_to_text) and spoken output (flutter_tts).
• Text chat command bar for direct typed interaction.
• Local Ollama chat integration.
• Web search summarization flow.
• Local memory + context retrieval (RAG-style prompts).
• Optional terminal command generation/execution.
• Personality modes: classic, tactical, casual.
• Linux TTS fallback (spd-say then espeak-ng) when plugin speech is unavailable.

Tech Stack

• Flutter + Dart
• Riverpod state management
• Dio for HTTP calls
• SharedPreferences for settings persistence
• Ollama local API (/api/generate, /api/embeddings)

Requirements

• Flutter SDK (Dart ^3.11.1)
• Ollama running locally at http://localhost:11434/api
• One or more installed local models
• Linux desktop target recommended

Optional Linux speech fallback packages:

sudo apt install -y speech-dispatcher espeak-ng

Quick Start

flutter pub get
flutter run -d linux

Ollama Setup

ollama serve
ollama pull jarvis-7b:latest
ollama pull llama3.1:8b
ollama pull llama3.2:3b
ollama pull mistral-nemo:12b

How To Use

1. Launch the app.
2. Tap the center core to toggle voice listening.
3. Use the bottom command bar for text chat.
4. Watch response/status logs in the right panel.
5. Change model and personality mode from Settings.

Personality Modes

• classic: calm, witty, JARVIS-like.
• tactical: direct, mission-focused.
• casual: friendly, concise.

Location:

• Settings -> Personality Mode

Key Files

• lib/main.dart
• lib/features/jarvis/jarvis_screen.dart
• lib/features/jarvis/jarvis_provider.dart
• lib/core/settings_provider.dart
• lib/core/ollama_service.dart
• lib/core/memory_service.dart

Troubleshooting

• No model response:
  • Ensure ollama serve is running.
  • Confirm selected model exists locally.
• No voice output on Linux:
  • Confirm system audio is working.
  • Install speech-dispatcher and espeak-ng.
• Text chat not sending:
  • Use Enter or send button in the bottom command bar.

License

No license file is currently defined in this repository.