Skip to content

Getting Started

System Requirements

macOS Linux
Desktop App (GUI) Supported Not supported
Headless / CLI / MCP Supported Supported
  • JDK 17+ is required on all platforms
  • Android SDK with adb on your PATH for on-device testing

Start the Trailblaze Desktop App

Clone the repo and run the desktop app locally. 

./trailblaze

Set your LLM Provider API Key

Trailblaze includes built-in support for the following providers: - OpenAI (OPENAI_API_KEY) - Anthropic (ANTHROPIC_API_KEY) - Google (GOOGLE_API_KEY) - OpenRouter (OPENROUTER_API_KEY) - Ollama (no API key required) 1. Set up your provider API key on the development machine in your shell environment. The environment variable names are defined in LlmProviderEnvVarUtil. 

export OPENAI_API_KEY="your_api_key_here"
The desktop app reads these values from your shell environment at startup, so make sure they are set before launching.

Next: Android On-Device Testing

If you want to run tests on Android devices or emulators, see Android On-Device Testing.

Optional: Host JVM Unit Tests

If you need to run Trailblaze from JUnit (not the desktop app), see Host JVM Unit Tests.