Skip to main content

Quickstart

Get Aucert running and execute your first AI-powered mobile test in under 5 minutes.

Prerequisites​

  • Node.js 20+ installed (node --version to check)
  • An Android project (APK or AAB) or a connected emulator
  • An Aucert account (sign up)

Step 1: Install the CLI​

npm install -g @aucert/cli

Verify the installation:

aucert --version
# Expected: @aucert/cli/x.y.z
tip

Prefer a different package manager? See installation options for yarn and pnpm.

Step 2: Authenticate​

aucert auth login

This opens a browser window for OAuth authentication and stores your credentials locally.

Step 3: Initialize your project​

cd your-android-project
aucert init

This creates an aucert.config.yaml in your project root with sensible defaults. It auto-detects your app type, package name, and source locations.

aucert.config.yaml (generated)
app:
  platform: android
  package: com.example.myapp
  source: ./app/src/main
test:
  parallelism: 1
  timeout: 300s

Step 4: Run your first test​

aucert run

Aucert will:

  1. Ingest your app through the Knowledge Graph — parsing code ASTs, UI layouts, and API schemas to build a model of your app
  2. Generate test scenarios automatically — targeting critical user flows, edge cases, and regression areas
  3. Execute tests on an emulator — navigating your app with AI-powered interaction
  4. Analyze results with visual reasoning — comparing expected vs actual behavior using screenshot analysis
  5. Report with confidence scores — each result includes a pass/fail decision with a confidence percentage

Step 5: View results​

aucert status

This shows a summary of the test run with pass/fail counts and confidence scores:

Test Run #1 — 12 scenarios
  ✅ 10 passed (avg confidence: 97.2%)
  ❌  1 failed (confidence: 89.1%) — Login screen: password field not masked
  ⚠️  1 low confidence (72.3%) — Settings: dark mode toggle

Bug report: ./aucert-reports/run-001/bugs.md
Screenshots: ./aucert-reports/run-001/screenshots/
tip

Add --watch to see results in real-time as tests execute: aucert run --watch

Troubleshooting​

Error: No Android SDK found

Cause: Aucert needs the Android SDK to launch emulators.

Fix: Install Android Studio or set ANDROID_HOME:

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
Error: Authentication failed

Cause: OAuth token may have expired or browser didn't complete the flow.

Fix:

aucert auth logout
aucert auth login
Error: No emulator available

Cause: No Android emulator is running or configured.

Fix: Create and start an emulator:

# List available system images
sdkmanager --list | grep system-images

# Create an AVD
avdmanager create avd -n aucert-test -k "system-images;android-34;google_apis;x86_64"

# Start it
emulator -avd aucert-test &

What's next​