DOCUMENTATION & TECHNICAL SPECS

2-Minute Setup Guide — plus full Security & Architecture specs.

Set up this local AI assistant for Windows with offline AI voice assistant speech, DPAPI vault encryption, SHA-256 checksums, and Spend Caps.

Install on Windows & start your 7-day free trial

Quickstart 01 · 1 min

Runassi operates natively on Windows 10 / 11 (64-bit). Zero server rental or terminal setup required.

  1. 01Download Runassi-Setup-1.0.0-early-access-x64.exe from the Download page (/download).
  2. 02Double-click to install like any everyday office application and choose your local working folder.
  3. 03Sign in to start your 7-day free trial immediately with no credit card required.

2-Minute AI Setup Wizard (Google Gemini Free Tier or BYO Key)

Quickstart 02 · $0 API

First launch walks you step by step through connecting your own free Google Gemini tier ($0 API) directly from Windows.

  1. 01Click "Connect Free Google Gemini (2 min)" inside the welcome wizard — zero billing card needed for starter tiers.
  2. 02Prefer Anthropic Claude or OpenAI? Paste your own key anytime and enable soft alerts plus a hard monthly Spend Cap.
  3. 03Your key is sealed straight into Windows DPAPI Vault and never sent through middleman servers.

Voice, local files & Word / Excel export

Quickstart 03 · Everyday Use

Pick one of the 5 built-in workflows, drop a local PDF/price sheet, or hold the microphone button to speak naturally.

  1. 01Click the microphone icon to speak naturally in English or supported languages via local offline voice models.
  2. 02Drag any long contract PDF, spreadsheet, or note directly into the task window.
  3. 03Export results straight to Word (.docx), Excel (.xlsx), PDF, or one-click copy for Email, Slack, Microsoft Teams, or WhatsApp.

Local PC Architecture (Windows DPAPI, SQLite, 1-Click Backup)

Security & Tech Specs

All Stage 1 local security guarantees and zero lock-in exports live cleanly on your Windows drive.

  1. 01Local Data Store: Workspaces, reminders, and workflow histories are saved locally in SQLite alongside built-in hermes_skills workflows.
  2. 02Secret Protection: Session tokens and AI provider keys are sealed locally via Windows DPAPI Vault—never stored on external proxies.
  3. 03Offline Speech Runtime: Voice recognition and playback operate locally via Sherpa STT + Piper TTS.
  4. 04Zero Vendor Lock-In: 1-Click Encrypted Backup/Restore moves Windows machines cleanly, alongside open Markdown (.md) and JSON export.

Verify Windows .exe integrity with Get-FileHash SHA-256

Verification · SHA-256

IT and security teams can verify installer integrity before execution using built-in Windows PowerShell.

  1. 01Open PowerShell inside your Downloads folder after fetching the .exe installer.
  2. 02Run Get-FileHash and compare the SHA-256 output against the published checksum on /download.
PowerShell — Verify installer SHA-256 checksum
Get-FileHash .\Runassi-Setup-1.0.0-early-access-x64.exe -Algorithm SHA256

Custom AI Spend Cap Defaults & Multi-Provider Routing

Controls · Spend Cap

Optional soft alerts and hard auto-stop thresholds ensure zero unexpected API bills when pairing paid keys.

  1. 01Use Google Gemini Free Tier at $0 API cost, or attach a paid provider key inside Settings.
  2. 02Set soft monthly alerts and hard auto-stop Spend Cap thresholds directly in Settings.
Recommended Spend Cap config
monthly_soft_alert_usd = 2.00
monthly_hard_stop_usd  = 5.00
per_run_token_guard    = 40000

Stage 2 Roadmap: Optional BYO-VPS (Setup Cloud) & macOS

Roadmap · Stage 2

Stage 1 requires $0 VPS and operates completely on Windows. Stage 2 adds optional 24/7 personal Linux VPS sync and macOS support.

  1. 01Stage 2A (1-Click Setup Cloud): Enter personal Linux VPS SSH credentials locally inside PC Settings (password wiped from RAM immediately after generating scoped keys).
  2. 02Stage 2A (Conflict-Free Two-Folder Sync): Unidirectional runassi_pc (PC → VPS) and runassi_cloud (VPS → PC) folders preserve .local-edit conflict copies safely.
  3. 03Stage 2B (macOS Edition): Native macOS package using macOS Keychain in place of Windows DPAPI.