wis-free-v3

A high-performance, cross-platform (Windows & Linux) voice dictation application built in Go using the Wails framework. wis-free-v3 provides instant speech-to-text with AI-powered refinement, operating as a background service with global hotkey support.

---

🚀 Features

• Blazing Fast: Native implementation ensures zero lag during recording and transcription.
• Global Accessibility: Trigger from anywhere via configurable global hotkeys.
• Cross-Platform: Supports Windows natively and Linux (X11 strongly recommended; Wayland users may need to map desktop shortcut triggers).
• AI-Powered Refinement: Integrates Groq (Whisper + Llama) for intelligent punctuation and grammar fixing.
• Offline Capability: Supports local Whisper.cpp for sensitive or offline workflows.
• Micro-Automation: Automatically pastes transcribed text directly into your active window.
• Ultra-Leighton: Low memory footprint while running in the system tray.

📂 Project Structure

.
├── assets/             # Branding and icons
├── build/              # Wails build artifacts and manifests
├── frontend/           # Svelte/Vue/React settings UI
├── internal/           # Private application logic
│   ├── audio/          # Sound capture and processing
│   ├── config/         # Persistent configuration management
│   ├── hotkey/         # Global keyboard hooks
│   ├── logger/         # Structured logging utilities
│   ├── services/       # Cloud and local AI providers
│   ├── system/         # Windows OS integration (Startup/Tray)
│   └── ui/             # Native overlay and window management
├── scripts/            # Development and deployment automation
├── app.go              # Application lifecycle management
├── main.go             # Entry point
└── wails.json          # Project configuration

🛠️ Getting Started

Prerequisites

• Go: 1.23 or higher
• Wails CLI: go install github.com/wailsapp/wails/v2/cmd/wails@latest
• Compiler: GCC (TDM-GCC recommended for Windows)

Installation & Build

1. Clone the repository.
2. Run the build script:

   .\scripts\build.bat
   

3. The executable will be available in build\bin/wis-free-v3.exe.

⚙️ Configuration

Settings are managed via the built-in UI (Right-click tray → Settings) or manually in %USERPROFILE%\.wis-free-v3\config.json.

{
    "api_key": "gsk_...",
    "shortcut": "alt+z",
    "whisper_model": "whisper-large-v3-turbo",
    "ai_model": "llama-3.3-70b-versatile"
}

🤝 Contributing

This project is maintained with a focus on code quality and modular architecture. Please ensure all logic remains within the internal/ package to maintain clean boundaries.

📄 License

Distributed under the MIT License. See LICENSE for more information.