Getting Started
Learn how to set up and configure your Thox.ai device for the first time.
How to set up your Thox.ai device
Before you begin
Make sure you have the following items from your Thox.ai package: the device, USB-C power adapter (65W), Ethernet cable, and Quick Start Guide.
Step 1: Choose a location
Place your Thox.ai device on a flat, stable surface with good ventilation. Ensure at least 2 inches of clearance on all sides for proper airflow. Avoid enclosed spaces or areas near heat sources.
Step 2: Connect to power
Connect the included USB-C power adapter to the device and plug it into a power outlet. The device supports USB-C Power Delivery (PD) and requires 45-65W.
Step 3: Connect to network
For initial setup, we recommend using the included Ethernet cable. Connect one end to your Thox.ai device and the other to your router or network switch. You can configure Wi-Fi later.
Step 4: Wait for boot
The LED will pulse white during boot, turn yellow during initialization, blue during network configuration, and finally green when ready. This process takes 60-90 seconds.
Connecting to your local network
Ethernet connection (recommended)
Simply plug the Ethernet cable into the device and your router. The device uses DHCP by default and will automatically obtain an IP address.
Finding your device
Access your device via http://thox.local:8080 (requires mDNS support) or check your router's DHCP client list for the device's IP address.
Wi-Fi setup
To configure Wi-Fi, access the web interface at http://thox.local:8080/admin or use the CLI: thox wifi setup --ssid "YourNetwork" --password "YourPassword"
Static IP configuration
For static IP assignment, use the CLI: thox network config --ip 192.168.1.100 --gateway 192.168.1.1 --dns 8.8.8.8
First boot and initial configuration
Understanding LED indicators
White pulsing: Starting up. Yellow: Initializing. Blue: Network activity. Green solid: Ready and idle. Green pulsing: Processing.
Accessing the admin interface
Once the LED is green, navigate to http://thox.local:8080/admin in your browser. The default credentials are admin/admin - you'll be prompted to change these on first login.
Initial calibration
Run the calibration wizard to optimize performance for your workload: thox calibrate --auto. This analyzes your hardware and network conditions for optimal settings.
Selecting your first model
The device comes with thox-coder pre-installed. To see available models: thox models list. To download additional models: thox models pull [model-name]
Installing the VS Code extension
Installation
Open VS Code, go to Extensions (Ctrl+Shift+X), search for "Thox.ai", and click Install. Restart VS Code when prompted.
Configuration
Open VS Code settings (Ctrl+,) and search for "thox". Set the host to your device address (thox.local or IP) and port (default 8080).
Testing the connection
Open the Command Palette (Ctrl+Shift+P) and run "Thox: Test Connection". You should see a success message if the extension can reach your device.
Using completions
Start typing code and the extension will automatically provide AI-powered suggestions. Press Tab to accept a completion or Escape to dismiss.