Getting Started with TINAA¶

Welcome to TINAA! This guide will help you get started with AI-powered browser automation and testing.

Prerequisites¶

Before you begin, ensure you have: - TINAA running (Installation Guide) - A web application to test - Basic knowledge of HTTP APIs or MCP integration

Your First Test¶

Step 1: Verify TINAA is Running¶

curl http://localhost:8765/health

Expected response:

{
  "status": "healthy",
  "version": "1.0.0"
}

Step 2: Run an Exploratory Test¶

Execute an AI-guided exploratory test on your application:

curl -X POST http://localhost:8765/test/exploratory \
  -H "Content-Type: application/json" \
  -d '{
    "action": "exploratory",
    "parameters": {
      "url": "https://your-app.com",
      "focus_area": "forms"
    }
  }'

Step 3: Check Accessibility¶

Run an accessibility audit:

curl -X POST http://localhost:8765/test/accessibility \
  -H "Content-Type: application/json" \
  -d '{
    "action": "accessibility",
    "parameters": {
      "url": "https://your-app.com",
      "standard": "WCAG2AA"
    }
  }'

Using with Claude Desktop¶

If you're using TINAA with Claude Desktop:

Configure Claude Desktop to use TINAA as an MCP server
Ask Claude to:
"Navigate to my website and take a screenshot"
"Check the accessibility of my login page"
"Perform exploratory testing on my checkout flow"

Understanding Test Results¶

TINAA provides detailed test results including: - Test execution logs - Screenshots of key interactions - Accessibility violations found - Performance metrics - Recommendations for improvements

Real-time Progress Tracking¶

Connect via WebSocket to see live test progress:

const ws = new WebSocket('ws://localhost:8765/ws');

ws.onmessage = (event) => {
  const progress = JSON.parse(event.data);
  console.log(`${progress.action}: ${progress.status}`);
};