Webagent.cloud SOP

Appearance

Test ​

Status: NEEDS-ACCOUNT (GitHub clone + Docker + LLM API keys) ​

Classification: NEEDS-ACCOUNT / self-hosted via GitHub clone

webagent.cloud has no published pip or npm package.

  • pip install webagent-cloud returns: ERROR: No matching distribution found
  • No npm package found under any obvious name

The project is a self-hosted API that must be cloned from GitHub (github.com/FydeOS/webagent), configured with a database, and supplied with LLM API keys before any API calls are possible.

What is required ​

  1. Clone the repository:

    bash
    git clone https://github.com/FydeOS/webagent.git
cd webagent

  2. Set up the database and environment (see the repo README for the exact steps).

  3. Provide LLM API keys in the environment configuration.

  4. Start the server (Docker Compose is the supported path):

    bash
    docker compose up

Smoke test (self-hosted, after full setup) ​

After starting the server with python server.py, run:

bash
curl -s -X POST http://localhost:8000/api/runs \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Go to https://example.com and return the page title.",
    "model": "o3",
    "provider": "openai",
    "wait_for_completion": true
  }'

Success output looks like:

json
{
  "task_id": 1,
  "task_run_id": 1,
  "history": [
    {
      "description": "Navigating to example.com",
      "actions": [
        { "name": "navigate", "params": { "url": "https://example.com" }, "success": true }
      ]
    }
  ],
  "result": "Example Domain",
  "is_done": true,
  "is_successful": true,
  "status": "success"
}

The key success indicators are "is_done": true, "is_successful": true, and "status": "success". The result field will contain the agent's plain-text answer.

Local server health check ​

If you just want to confirm the server is up without running an agent task:

bash
curl -s http://localhost:8000/

A 200 response (any JSON body) confirms the Python server is listening.

Notes ​

  • There is no hosted cloud API with a free tier. The service must be self-hosted.
  • The self-hosted smoke test requires a running LLM API key and a reachable browser (local Chromium or a cloud provider key). Without valid credentials the run will return "is_successful": false with an error message in result.
  • tested=false: the server requires a full Docker environment and LLM API credentials. No one-liner install or package check is available.