Desktop Agent

cd os_services/desktop_os
pip install -e .

curl -fsSL https://your-domain.com/install.sh | bash

# Run with your user ID (required)
isa-desktop --owner YOUR_USER_ID --server http://pool-manager:8090

# Share desktop with others
isa-desktop --owner YOUR_USER_ID --visibility shared
 
# Run in sandbox mode (restrict to home directory)
isa-desktop --owner YOUR_USER_ID --sandbox
 
# Custom name and tier
isa-desktop --owner YOUR_USER_ID --name "My Workstation" --tier workstation

{
  "tool": "read_file",
  "params": {"path": "/home/user/document.txt"}
}

{
  "tool": "write_file",
  "params": {
    "path": "/home/user/output.txt",
    "content": "Hello, World!"
  }
}

{
  "tool": "list_directory",
  "params": {"path": "/home/user"}
}

{
  "tool": "execute_bash",
  "params": {"command": "ls -la"}
}

{
  "tool": "get_clipboard",
  "params": {}
}

{
  "tool": "set_clipboard",
  "params": {"content": "Text to copy"}
}

{
  "tool": "screenshot",
  "params": {"region": "full"}  # or specific coordinates
}

{
  "tool": "open_application",
  "params": {"app": "code"}  # VS Code
}

{
  "tool": "open_url",
  "params": {"url": "https://example.com"}
}

{
  "tool": "get_system_info",
  "params": {}
}

User/Agent → APISIX → Thin Agent Proxy → Pool Manager → Desktop Agent

import httpx
 
async def execute_on_desktop(desktop_id: str, tool: str, params: dict):
    async with httpx.AsyncClient() as client:
        response = await client.post(
            f"http://pool-manager:8090/pools/desktop/{desktop_id}/execute",
            json={
                "action": tool,
                "params": params
            }
        )
        return response.json()
 
# Example: Read a file
result = await execute_on_desktop(
    "desktop-abc123",
    "read_file",
    {"path": "/home/user/notes.txt"}
)

@mcp.tool()
async def desktop_bash(desktop_id: str, command: str):
    """Execute bash command on desktop"""
    return await execute_on_desktop(
        desktop_id,
        "execute_bash",
        {"command": command}
    )