Skip to content

Rau1CS/vtdesk-releases

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

vtdesk - Desktop Trading Bot Runner

Desktop application for automated trading strategies with 24/7 execution

Latest Release Downloads

Overview

vtdesk extends the vtdesk web platform with desktop-exclusive features for serious traders who need reliable, always-on bot execution.

Feature Web App Desktop App
Trading interface Yes Yes
Agent assistant Yes Yes
Local persistence No Yes
Background bots No Yes (24/7)
Copy trading Partial Full
Agent keys Browser Encrypted local
Auto-updates N/A Yes
Paper trading Yes Yes
Backtesting No Yes (local)

Downloads

Latest Release

Platform Download Format
Windows Download .exe installer
macOS Download .dmg
Linux Download .AppImage / .deb

Installation

Windows

  1. Download vtdesk-setup-*.exe
  2. Run installer and follow prompts
  3. Launch from Start Menu

macOS

  1. Download vtdesk-*.dmg
  2. Open and drag to Applications
  3. First launch: Right-click > Open (to bypass Gatekeeper)

Linux

chmod +x vtdesk-*.AppImage
./vtdesk-*.AppImage

Quick Start

  1. Launch vtdesk - App starts minimized to system tray
  2. Import Bot - File > Import Bot Configuration (.json)
  3. Enter Passphrase - Required to decrypt agent keys
  4. Enable Bot - Toggle in tray menu or dashboard
  5. Monitor - View real-time status and trade history

Paper Trading

Test strategies without risking real funds:

  • Enabled by default - Switch between live/paper in bot config
  • Realistic simulation - Uses live market data for fills
  • Full metrics - Track PnL, win rate, drawdown
  • No credentials needed - Test before connecting real accounts

Export a bot in paper mode from the web app, or set "mode": "paper" in your bot config.

Backtesting

Run strategies against historical data locally:

{
  "version": "1.0",
  "symbol": "BTC-USD",
  "interval": "1h",
  "startTime": 1704067200000,
  "endTime": 1735689600000,
  "bars": [...]
}

Load data bundles and run backtests entirely on your machine - no cloud compute, no data sharing.

Bot Configuration

Bots are exported from the web app as JSON packages:

{
  "version": "1.0",
  "botId": "uuid",
  "name": "My Trading Bot",
  "mode": "paper",
  "venueId": "hyperliquid",
  "strategy": {
    "type": "copy_leader",
    "params": {
      "leaderAddress": "0x...",
      "maxPositionUsd": 1000
    }
  },
  "credentials": { ... },
  "schedule": { "intervalMinutes": 5 }
}

Supported Strategies

Strategy Description
copy_leader Follow and mirror trades from a leader
simple_scalper Quick entry/exit on price movements
grid Place orders at intervals around price
dca Dollar-cost average on schedule

Supported Venues

  • Hyperliquid - Perpetual derivatives
  • Aster - Decentralized derivatives
  • Lighter - Order book trading

Security

  • Non-custodial - Keys never leave your device
  • Encrypted storage - PBKDF2 + AES-256-GCM
  • Local execution - No cloud dependencies
  • Signed releases - Verified binaries
  • Context isolation - Electron security best practices

System Requirements

Minimum Recommended
OS Windows 10, macOS 10.14, Ubuntu 18.04 Windows 11, macOS 12+, Ubuntu 22.04
RAM 4GB 8GB
Storage 500MB 2GB
Network Broadband Stable low-latency

Auto-Updates

vtdesk checks for updates automatically:

  • Background download (no interruption)
  • Install on next restart
  • Manual check: Help > Check for Updates
  • Rollback protection with signed releases

Troubleshooting

Bot won't start

  • Verify passphrase is correct
  • Check venue credentials are valid
  • Ensure network connectivity

Connection errors

  • Verify internet connection
  • Check venue API status
  • Try paper trading mode first

Logs location

  • Windows: %APPDATA%/vtdesk/logs/
  • macOS: ~/Library/Logs/vtdesk/
  • Linux: ~/.config/vtdesk/logs/

Support

License

Proprietary software. See LICENSE for terms. By installing or using this software, you agree to the VTDesk Desktop Runner License.


Risk Warning: Automated trading involves substantial risk. Past performance does not guarantee future results. Never trade with funds you cannot afford to lose.

Security Notice: Never share your agent keys or passphrase. vtdesk does not have access to your keys, keys are stored locally encrypted, you are responsible for securing your device.

About

electron app desktop runner for vtdesk trading bots

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors