Task Mode Configuration

CUGA supports three distinct task execution modes, each optimized for different use cases. Choose the mode that best fits your workflow requirements.

🎯 Available Task Modes

How Task Modes Work

API Mode (mode = 'api')

• Opens tasks in a regular web browser
• Best for API/Tools-focused workflows and testing
• Optimized for server-side operations
• Minimal resource usage

Web Mode (mode = 'web')

• Interface inside a browser extension (available next to browser)
• Optimized for web-specific tasks and interactions
• Direct access to web page content and controls
• Perfect for web automation workflows

Hybrid Mode (mode = 'hybrid')

• Opens inside browser extension like web mode
• Can execute both API/Tools tasks and web page tasks simultaneously
• Starts from configurable URL defined in demo_mode.start_url
• Most versatile mode for complex workflows combining web and API operations

Configuration

Basic Configuration

Edit ./src/cuga/settings.toml:

[demo_mode]
start_url = "https://opensource-demo.orangehrmlive.com/web/index.php/auth/login"  # Starting URL for hybrid mode

[advanced_features]
mode = 'api'  # 'api', 'web', or 'hybrid'

Use Case Examples

API Mode Use Cases

• Data Processing: Batch processing of API data
• Backend Integration: Server-to-server communication
• Testing: API endpoint validation
• Automation: Scheduled API tasks

Web Mode Use Cases

• Web Scraping: Data extraction from websites
• Form Automation: Filling out web forms
• UI Testing: Web application testing
• Content Management: Website content updates

Hybrid Mode Use Cases

• Data Integration: Fetch data via API and display on web pages
• Workflow Automation: Combine web and API operations
• User Experience: Enhance web interfaces with real-time data
• Business Processes: End-to-end automation workflows

Next Steps

After configuring task modes:

1. API Integration: Extend with custom APIs
2. Save & Reuse: Optimize workflows