Install POLYROB

POLYROB runs on your machine — self-hosted, no hosted version. Targets Python 3.11+. Bring a key for any LLM provider you have.

  1. Install

    $pipx install "polyrob[all]"

    Or a leaner install — see the extras table below.

  2. Add the browser engine (for web automation)

    $python -m playwright install chromium

  3. Configure

    $polyrob init

    Writes ~/.polyrob/.env. Add a provider key (e.g. OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY).

  4. Sanity-check

    $polyrob doctor

    Verifies Python, config, keys (redacted), provider/model, workspace, database, memory and ports.

  5. Start the agent

    $polyrob chat

    A terminal REPL with the full agent. One-shot instead? polyrob run "your task".

Turn on personal-agent mode

Unlock the self-evolving and goal-seeking loops (skills, curator, goal board, self-wake) — all on as a group for single-user, on your own machine:

# ~/.polyrob/.env
POLYROB_LOCAL=true

Install extras

ExtraWhat it adds
(none)Core agent, keyword memory, CLI
serverFastAPI REST API + WebView dashboard
browserPlaywright browser automation
memory-vectorSemantic vector recall for H-MEM (local local_vector backend)
cryptoAgent wallet, x402 pay-per-request, Hyperliquid / Polymarket
telegramTelegram chat surface
twitterTwitter/X outreach tool
voiceLocal voice transcription
allEverything above

Optional: dashboard & REST API

Web dashboard

$polyrob dashboard

Single-user web UI at http://localhost:5050.

REST API

$polyrob serve

Local REST API (+ A2A + OpenAI-compatible /v1) at http://localhost:9000.

Building an agent product on top? The multi-tenant, metering and on-chain-payment core is built in — see Deployment and the full capabilities.