FAQ

FAQ

General

What LLM do I need?

Any one of: Anthropic Claude, OpenAI GPT, Google Gemini, or Ollama (local). Configure API keys in Settings > LLM Configuration.

Can it work offline?

Yes. Install Ollama and use local models like Llama 3.2. No cloud API needed.

How many agents can run per PC?

Default is 5 per worker. Configurable in Settings. Depends on available RAM and CPU.

Is it secure?

Yes. JWT authentication, RBAC (Admin/Operator/Viewer), rate limiting (120 req/min), sandboxed code execution, security headers, audit logging. See Security.

What's the cost?

White-Ops is free (Apache 2.0). You only pay for LLM API usage. With Ollama, it's completely free.

Does it work on Windows?

Yes, via Docker Desktop. Install Docker Desktop for Windows, then follow the normal setup.

Does it work on Mac?

Yes. Requires Docker Desktop for Mac.

Agents

What's the difference between agent roles?

Roles are labels that help organize agents. They don't restrict capabilities - any agent can use any tool. Roles: general, researcher, analyst, writer, developer, assistant, accountant, hr.

Can agents access the internet?

Yes. The browser, web_search, and web_scraper tools provide full internet access via Playwright/Chromium.

Can agents communicate with each other?

Yes. Agents can email each other via the internal mail system, participate in collaboration sessions, and share knowledge via the Knowledge Base.

How do I add custom tools?

Create a Python file in worker/agent/tools/<category>/ extending BaseTool. It's auto-discovered at startup. See Contributing.

Tasks

How are tasks assigned to agents?

Either manually (select agent in task creation) or automatically (system assigns to an idle agent with matching capabilities).

What happens when a task fails?

It's retried up to max_retries times (default: 3). If all retries fail, status becomes failed with error details visible in Task Detail.

Can I schedule recurring tasks?

Yes. Use Operations > Schedules with cron expressions. Example: 0 9 * * 1 = every Monday at 9am.

Workers

How do I add another PC?

Run ./scripts/add-worker.sh <MASTER_IP> on the new PC, then approve in System > Workers. See Worker Management.

What if a worker goes offline?

Tasks are automatically redistributed to other workers. Admin receives notification.

Can workers be in different networks?

Yes, but they need network access to the master server (ports 8000, 6379, 9000). Use VPN/tunnel for remote workers.

Data

How do I backup?

make backup  # Backs up PostgreSQL

Files in MinIO are stored in Docker volumes. See Deployment Guide.

How do I update?

git pull
make build
make up

Where are files stored?

In MinIO (S3-compatible storage). Accessible via Files page or API.

Troubleshooting

Agent stuck in "busy" state

Restart the agent from Agents page (Stop then Start). Check worker logs: make logs-worker.

Can't login

Check .env for ADMIN_EMAIL and ADMIN_PASSWORD. Reset by restarting with new values.

Worker not connecting

Verify network: curl http://MASTER_IP:8000/health. Check firewall ports: 8000, 6379, 9000.

High memory usage

Reduce WORKER_MAX_AGENTS in .env. Each agent + browser instance uses ~200-500MB.