If you find this useful, a β helps others discover it
|
|
Download. Install. Done.
Download Β· Documentation Β· Blog Β· Changelog
| Others | Skales | |
|---|---|---|
| Setup | Docker, Terminal, CLI | Download EXE/DMG/AppImage, double-click |
| RAM | 1.5-3GB+ | ~300MB |
| OS | Linux / Docker required | Windows + macOS + Linux native |
| Time to first agent | Hours to days | 30 seconds |
| Updates | Manual rebuild | One-click auto-updater |
| Code Signing | Rarely | β Apple Developer ID |
π Built-in Browser (Beta) - Browse the web with AI assistance. Skales navigates, scrolls, clicks, and extracts content β all inside a built-in webview. Includes conversation log, session export as Markdown, cookie banner auto-accept, and browser history.
π¨ 4 Themes - Skales (default, light/dark toggle), Obsidian (dark, top navigation bar), Snowfield (light, icon rail), Neon (dark vibrant, icon rail). Each theme has its own navigation style.
π Dashboard Builder - Customizable dashboard with status cards, connections overview, memory word cloud, recent sessions, and optional widgets (calendar, weather, buddy, email, tasks, plan, stats). Toggle widgets on and off in edit mode.
β‘ Always-On Agent (Beta) - Schedule tasks with cron syntax or natural language. Background execution with log viewer. Identity Maintenance runs daily to keep Skales's memory of you up to date. System jobs are protected from accidental deactivation.
π Live Duplex Voice (Beta) - Talk to Skales naturally with real-time speech recognition (Groq Whisper, OpenAI Whisper, Azure Speech) and text-to-speech (ElevenLabs, OpenAI TTS, Azure Speech). Voice Activity Detection for hands-free conversations.
π± PWA Mobile Access (Beta) - Access Skales from your phone via Tailscale. QR code setup wizard, auto-detect Tailscale IP. Full desktop interface on mobile.
π€ Agent Swarm (Alpha) - Multi-instance collaboration via mDNS discovery. Skales instances on the same network can discover each other and delegate tasks.
π§ Newsletter & Feedback - Opt-in for update notifications with explicit consent. Report bugs directly from the app and track their status.
β Apple Code Signed - macOS builds are now signed with an Apple Developer ID certificate (Mario Simic, Q5ASU2DB6P). No more Gatekeeper workarounds on most systems.
π 9 Languages - English, Deutsch, EspaΓ±ol, FranΓ§ais, Π ΡΡΡΠΊΠΈΠΉ, δΈζ, ζ₯ζ¬θͺ, νκ΅μ΄ & PortuguΓͺs. 1732 translation keys fully synced.
π₯οΈ Native Desktop App - Runs as a proper desktop application. System tray, auto-start, graceful shutdown. No browser needed.
Multi-Provider Hub - 13+ LLM providers: OpenRouter, OpenAI, Groq, Anthropic, Google, Mistral, Together AI, xAI, DeepSeek, Minimax, Replicate (BYOK), OpenAI Compatible endpoint (KoboldCpp, LM Studio, vLLM), and local Ollama.
π Built-in Browser (Beta) - AI-assisted web browsing with navigation, scrolling, clicking, DOM-to-Markdown extraction, cookie banner auto-accept, session history, and export as Markdown.
π¦ Lio AI - Code Builder - Multi-AI code builder. Architect designs, Reviewer improves, Builder executes. Live preview. Build entire projects from plain language. Deploy to FTP/SFTP with one click.
π Planner AI (Beta) - AI-powered daily scheduling. 8-step wizard learns your work patterns, generates time-blocked plans from your calendar events, and pushes them back. Day and week views.
π¨ 4 Themes - Skales (default, light/dark), Obsidian (dark, top nav), Snowfield (light, icon rail), Neon (dark, icon rail).
π Dashboard Builder - Customizable with status cards, word cloud, recent sessions, and toggleable widgets.
β‘ Always-On Agent (Beta) - Cron-based task scheduling with natural language, log viewer, and protected system jobs.
π Live Duplex Voice (Beta) - Real-time STT/TTS with VAD (Groq Whisper, OpenAI, Azure, ElevenLabs).
π± PWA Mobile Access (Beta) - Phone access via Tailscale with QR code setup.
π€ Agent Swarm (Alpha) - mDNS-based multi-instance discovery and task delegation.
ποΈ Vision & Screenshots - Desktop screenshot analysis, image recognition, vision-capable model fallback across all channels.
π¬ Telegram & WhatsApp - Chat with Skales on the go. Full remote control via Telegram with admin menus.
π§ Email Integration - Read, compose, reply, search, manage emails with attachments. IMAP/SMTP with safety gates. Multi-account support with per-mailbox whitelists.
π Calendar Integration - Google Calendar (OAuth), Apple Calendar (CalDAV), Outlook (Microsoft Graph API). Read/write access, event reminders.
π Twitter/X Integration - Post tweets, read timeline, reply to mentions. OAuth 1.0a.
π‘οΈ Safety Mode - Two modes: Safe (all actions require approval) and Unrestricted (full autonomy).
π§ Bi-Temporal Memory - Auto-extracts facts and preferences from conversations. Short-term, long-term, and episodic memory. Injected as context before every reply.
π₯ Group Chat - Multiple AI personas debate your questions in configurable rounds.
β Autopilot - Fully autonomous background agent. Deep-Dive Interview, Master Plan, OODA self-correction loop. Human-in-the-loop approval gates. Kanban board.
π§ Skill AI - Custom Skills - Upload .skill.zip packages to add new capabilities. AI-generated skill scaffolding. Hot-reload without restart.
π£οΈ Voice Chat - Full duplex voice interface. Speak to Skales and hear replies.
π Security - Sandboxed file access (3 modes), command blacklist, domain blocklist, VirusTotal scanning.
π Document Generation - Create Excel (.xlsx), Word (.docx), and PDF files from natural language.
πΊοΈ Google Places - Search nearby places, geocode addresses, get directions, fetch business details.
πΊ DLNA Media Casting - Discover and cast media to smart TVs, speakers, and Chromecast on your network.
π Network Scanner - Discover all devices on your LAN. Detects other Skales instances.
π FTP/SFTP Deploy - Central server profile management. Deploy Lio AI projects with one click.
π Live Web Search - Real-time, cited search results via Tavily.
π¨ Image & Video Generation - Google Imagen 3, Veo 3, Replicate SDXL, FLUX, and 50+ more models.
π OpenAI Compatible - Connect KoboldCpp, LM Studio, vLLM, or any OpenAI-compatible local server.
π£οΈ Local TTS/STT - Text-to-speech via KoboldCpp or XTTS, speech-to-text via local Whisper. Fully offline voice I/O.
π¨ Local Image Generation - Generate images with locally running Stable Diffusion or FLUX.
π§ Newsletter & Feedback - Opt-in update notifications, in-app bug reporting with status tracking.
π¦ Desktop Buddy - Animated mascot on your desktop. 3 skins: Skales (gecko), Bubbles (blob), Capy (capybara). Proactive intelligence: meeting reminders, email alerts, end-of-day summaries. Click to open spotlight input. Approve/Decline tools directly in the speech bubble.
π€ Agent-to-Agent Protocol - /api/agent-sync endpoint for multi-Skales collaboration on the same network.
πΎ Export / Import Backup - One-click ZIP backup of all settings, memories, and integrations.
π Skales+ - Coming soon. Free tier stays free forever. Join the waitlist from Settings.
| Platform | Download | Notes |
|---|---|---|
| macOS (Apple Silicon) | Download DMG (M1-M4) | β Code Signed |
| macOS (Intel) | Download DMG (Intel) | β Code Signed |
| Windows | Download EXE | Standard installer |
| Linux | Download AppImage | x86_64 |
- Download for your platform from skales.app
- Run the installer (EXE, DMG, or AppImage)
- Skales opens as a desktop app
- Follow the setup wizard - add your API key and start chatting
No Terminal. No Node.js. No Docker. No npm.
macOS users: Skales is code-signed with an Apple Developer ID. Simply open the DMG and drag to Applications. If you still see a Gatekeeper warning (rare with signed builds), right-click the app β Open β click Open in the dialog. Alternatively, run once in Terminal:
sudo xattr -rd com.apple.quarantine /Applications/Skales.app
Windows users: If Windows SmartScreen shows a warning, click More info then Run anyway.
Linux users: Download the AppImage, make it executable (
chmod +x Skales-*.AppImage), and run. Some features (browser control) may require Chromium β Skales will show an installation hint if needed.
| Layer | Technology |
|---|---|
| Desktop Shell | Electron (main process, tray, auto-updater) |
| Frontend | Next.js 14 (App Router, standalone output) |
| Styling | Tailwind CSS |
| Language | TypeScript |
| Bots | Node.js (Telegram, WhatsApp, Discord) |
| Storage | ~/.skales-data (JSON) |
| Updates | electron-updater (auto, silent) |
| Build | electron-builder (NSIS / DMG / AppImage) |
| Signing | Apple Developer ID (macOS) |
Contributions are welcome for bug fixes and non-commercial improvements.
- Fork the repository:
https://github.com/skalesapp/skales - Create a feature branch:
git checkout -b fix/your-fix - Commit your changes:
git commit -m "fix: description" - Push and open a Pull Request
Please read the BSL-1.1 license before contributing. All contributions are subject to the same license terms.
- @btafoya - Linux support, first community contributor
- @bmp-jaller - IPv6 localhost fix
- @henk717 - KoboldCpp feedback, shaping the local AI experience
- @SohaibKhaliq - Korean translation
- @VladB-evs - Portuguese translation
- BYOK (Bring Your Own Key): API requests go directly from your machine to the provider. No middleman.
- Local-First Storage: All data stays on your machine in
~/.skales-data. - Offline Capable: With Ollama, Skales works entirely offline.
- Sandboxed Autonomy: File operations run in a configurable sandbox (Unrestricted / Workspace Only / Custom Folders).
- Code Signed: macOS builds signed with Apple Developer ID for verified integrity.
Skales can browse the web, execute commands, and manage files on your behalf. Always review what you ask it to do.
Skales started in early 2025 as a bloated Laravel SaaS project. I scrapped it all and rebuilt it as a native desktop app - the result is a local-first AI companion that feels like a real product, not a developer tool.
I'm Mario Simic - 10+ years in Marketing & Design. I got tired of agents that require Terminal setups and Docker containers. So I built something better.
- Claude & Google Gemini - For powering the development workflow.
- OpenRouter - The best hub for accessing the world's greatest LLMs.
Business Source License 1.1 (BSL)
Free for personal & educational use. Commercial use requires a license: dev@mariosimic.at
See COMMERCIAL-LICENSE.md for details.
Local AI Agent (Source Available) - v7.2.0 "The Next Chapter" is the latest release under BSL-1.1.
skales.app Β· GitHub Β· Blog
Built with β€οΈ by Mario Simic
Not just an agent. Your desktop companion. π¦π§π¦«
