Guide

Getting Started

Set up Whatszara in under a minute. No Python required. Just Go, Node.js, and Rust.

Prerequisites

  • Go — for the WhatsApp bridge (whatsmeow)
  • Node.js 20+ + Rust — for the Tauri desktop app
  • FFmpeg — optional, for audio message support

Python is NOT required.

One-Click Setup

chmod +x setup.sh && ./setup.sh

# Or using Make:
make setup

This installs Go, Node.js, Rust, and all dependencies automatically.

Run Whatszara

You need two terminals:

1. Start WhatsApp Bridge

make bridge

Scan the QR code with your WhatsApp mobile app to link your account.

2. Start Desktop App

make desktop

The Tauri app opens with a dashboard showing provider status and action log.

Configure LLM Provider

Set environment variables or configure in the desktop app GUI:

# Ollama (default — works out of the box)
export OLLAMA_ENDPOINT=http://localhost:11434

# Claude
export ANTHROPIC_API_KEY=sk-ant-...

# Groq
export GROQ_API_KEY=gsk-...

# Grok (xAI)
export XAI_API_KEY=...

# Gemini
export GEMINI_API_KEY=...

Send Your First Command

Once everything is running, send a WhatsApp message to your linked number:

Example messages:

  • "What is my current volume level?" — reads system volume
  • "Open Firefox" — launches the app
  • "Set volume to 30%" — changes system volume
  • "Show me my desktop images" — scans for images