rird

v2.3.0

Published

a month ago

AI-powered agent for browser automation, code generation, and computer use via command line.

0High
0Medium
0Low

eversale1

RIRD CLI

AI-powered agent for browser automation, code generation, and computer use via command line.

 _____ _        _______  ______
|  _  || |      |  _  \ |  __  \
| |_| || |      | |_| | | |  \ |
|  _  || |      |  _  < | |   | |
| | | || |_____ | |_| | | |__/ /
|_| |_||_______||_____/  |______/

RIRD AI Agent - v2.1.239

Features

Core Capabilities

AI-Powered Task Execution: Describe what you want, RIRD figures out how to do it
Browser Automation: Control web browsers programmatically with full anti-detection
Code Generation: Write, edit, and fix code in any language
Computer Control: Use mouse, keyboard, take screenshots, manage windows
File Operations: Read, write, edit files with context-aware changes
Multi-Model Support: Anthropic, OpenAI, Google, Deepseek, and more

Advanced Features

12+ Anti-Detection Mechanisms: Bypass bot protection and CAPTCHAs
Real-time Streaming: See results as they're generated
Session Management: Save and resume conversations
Cloud Execution: Run tasks on cloud servers
Offline Mode: Works without internet (24-hour cache)
Parallel Execution: Process multiple tasks concurrently
API Server Mode: REST API for remote task submission
Performance Tuning: Configure for speed, accuracy, or reliability

Quick Start

Installation

macOS/Linux/WSL:

curl -fsSL https://rird.ai/install.sh | bash

Windows (with npm):

npm install -g rird-ai

or:

# Use Git Bash
curl -fsSL https://rird.ai/install.sh | bash

1. Activate License

Get your license key from rird.ai:

rird activate YOUR_LICENSE_KEY

2. Run Your First Task

Interactive mode (recommended):

rird

Then type: Write a Python script that validates email addresses

Single command:

rird "What is 2 + 2?"

3. Configure (Optional)

Edit ~/.rird/engine/config.yaml to:

Change LLM model
Configure API keys
Adjust browser settings
Enable cloud execution

Common Use Cases

Web Scraping and Data Extraction

rird "Scrape all product names and prices from amazon.com and save to CSV"

Code Generation

rird "Generate a React component for user authentication with email and password fields"

Document Processing

rird "Extract all contact information from my PDF resume and format as JSON"

Testing and Validation

rird "Test my website login flow, including forgotten password recovery"

Data Analysis

rird "Analyze this CSV file and create a summary report with key metrics"

System Administration

rird "Find all jpg files in ~/Downloads, rename them with timestamps, and organize into folders by month"

Command Reference

For detailed command reference, see docs/CLI_REFERENCE.md

rird                          # Start interactive mode
rird "your task here"         # Run single task
rird help                     # Show all commands
rird --version                # Show version
rird activate <key>           # Activate license
rird status                   # Check license status
rird models                   # List available models
rird health-check             # Verify installation
rird debug                    # Show debug info
rird serve --port 9000        # Start API server

Installation & Setup

System Requirements

RAM: 2GB minimum, 4GB+ recommended
Disk: 500MB for RIRD + 1GB for cache
Network: Internet connection for LLM API
Python: 3.8+ (installed automatically)
Platforms: macOS, Linux, Windows, WSL

For detailed setup guide, see docs/PRODUCTION_SETUP.md

Configuration

Edit ~/.rird/engine/config.yaml to customize:

llm:
  mode: remote
  remote_url: https://rird.ai/api/llm
  main_model: 0000/ui-tars-1.5-7b:latest

browser:
  headless: true              # Show browser? (true/false)
  timeout: 30000              # Request timeout (ms)
  stealth_mode: true          # Anti-detection

execution:
  max_retries: 3
  task_timeout: 300000        # 5 minutes

logging:
  level: info                 # debug, info, warn, error
  file: ~/.rird/logs/rird.log

API Keys

Set your LLM provider keys via environment variables:

export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GOOGLE_GENERATIVE_AI_API_KEY="..."
rird "your task"

Or edit ~/.rird/engine/rird.json for persistent configuration.

Global Flags

These flags work with any command:

rird <task> --help            # Show command help
rird <task> -q                # Quiet mode (less output)
rird <task> --json            # Output as JSON
rird <task> --no-color        # Disable colored output
DEBUG=1 rird <task>           # Enable debug logging

Advanced Usage

Cloud Execution

Execute tasks on cloud servers:

rird --cloud "Complex analysis that needs more resources"

API Server Mode

Run as HTTP API server:

rird serve --port 8765

Then submit tasks:

curl -X POST http://localhost:8765/api/task \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"task": "What is 2+2?"}'

Batch Processing

Process multiple tasks:

while read task; do
  rird "$task" --json
done < tasks.txt

CI/CD Integration

name: RIRD Automation
on: [push]
jobs:
  task:
    runs-on: ubuntu-latest
    steps:
      - run: curl -fsSL https://rird.ai/install.sh | bash
      - run: rird activate ${{ secrets.RIRD_KEY }}
      - run: rird "Run automated tests" --json
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_KEY }}

Troubleshooting

Common Issues

License validation fails:

# Clear cache and re-validate
rm ~/.rird/license_cache.json
rird status

Out of memory:

NODE_OPTIONS=--max-old-space-size=4096 rird <task>

Network error:

# Check connectivity
ping rird.ai
# Use proxy if needed
export RIRD_PROXY="http://proxy:8080"

For more help, see docs/TROUBLESHOOTING.md or run:

rird health-check

Documentation

PRODUCTION_SETUP.md - Installation, configuration, scaling
CLI_REFERENCE.md - Complete command reference
ARCHITECTURE.md - System design and internals
TROUBLESHOOTING.md - Problem-solving guide

System Architecture

RIRD consists of:

CLI/TUI - Terminal user interface for interactive mode
Agent Engine - AI planning and task execution
Tool Execution - Browser automation, file I/O, computer control
LLM Integration - Support for multiple AI providers
License System - Device-bound license validation
Configuration - YAML-based settings management

See docs/ARCHITECTURE.md for detailed technical design.

Security

Privacy

Local-first: Conversations saved locally only
Device-bound licenses: Prevent key sharing
No telemetry: Unless explicitly enabled
Encrypted cache: 24-hour offline capability

Anti-Detection

RIRD implements 12+ techniques to bypass bot detection:

Fingerprint spoofing
Human-like timing and mouse movement
User-agent rotation
Proxy support
WebDriver detection evasion
Headless detection mitigation

See docs/ARCHITECTURE.md Security section for details.

Update and Support

Auto-Updates

RIRD automatically checks for updates (can be disabled):

rird upgrade  # Manual update
export RIRD_SKIP_AUTO_UPDATE=1  # Disable auto-updates

Getting Help

Documentation: https://rird.ai/docs
GitHub Issues: https://github.com/rird-ai/rird/issues
Community Forum: https://community.rird.ai
Email Support: [email protected]
Status Page: https://status.rird.ai

Report Issues

Run diagnostic command and include output:

rird health-check
DEBUG=1 rird <task> 2>&1 | head -200

Roadmap

[ ] Plugin system for custom tools
[ ] Distributed execution across multiple machines
[ ] Real-time multi-user collaboration
[ ] Advanced prompt caching
[ ] Custom model fine-tuning
[ ] Multi-agent coordination

License

RIRD requires a valid license key for production use.

Free Trial: 7 days, limited features
Pro: $49/month, full access
Enterprise: Custom pricing

Get started: https://rird.ai

Contributing

RIRD is built on open-source foundations (OpenCode fork). To contribute:

Fork: https://github.com/rird-ai/rird
Create feature branch: git checkout -b feature/amazing
Commit changes: git commit -am 'Add feature'
Push: git push origin feature/amazing
Open pull request

Credits

RIRD is forked from OpenCode, an open-source AI coding agent.

Key Technologies

Bun - Fast JavaScript runtime and package manager
TypeScript - Type-safe development
Claude AI - Primary LLM backend
Playwright - Browser automation
MCP Protocol - Tool integration standard
Drizzle ORM - Database access

Ready to get started?

curl -fsSL https://rird.ai/install.sh | bash
rird activate YOUR_LICENSE_KEY
rird

Questions? Email [email protected] or visit https://rird.ai/docs