gitwtfhub

wtf is polyrob?

theselfruleorg/polyrob — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A self hosted AI agent that runs on your own machine, plans and carries out goals, and learns from past sessions.

Mindmap

mindmap
  root((Polyrob))
    What it does
      Plans and completes goals
      Browses and edits files
      Runs code and commands
    Tech stack
      Python
      SQLite
      Playwright
    Use cases
      Automating recurring tasks
      Personal AI assistant
      Multi provider AI agent
    Audience
      Developers
      Vibe coders
      Self hosting enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a personal AI agent that plans and completes goals on your own machine.

REASON 2

Automate recurring tasks with plain language scheduling.

REASON 3

Connect an agent to Telegram, email, or other chat apps for remote control.

REASON 4

Give an AI agent long term memory of what it learned in past sessions.

What's in the stack?

PythonSQLitePlaywrightPyPI

How it stacks up

theselfruleorg/polyrob0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.11 or higher and at least one AI provider API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Polyrob is a self hosted AI agent that runs on your own computer instead of a company's cloud service. You give it a goal in plain language, and it plans the steps needed, browses the web, reads and writes files, runs code and shell commands, calls outside tools and APIs, and tries to recover on its own if something goes wrong along the way. The project supports every major AI provider, including OpenAI, Anthropic, Google, DeepSeek, OpenRouter, and NVIDIA NIM, and can automatically switch to a backup provider if one fails or is rate limited. It remembers what it learns between sessions and can be reached through several places: a terminal, a web dashboard, a REST API, or chat apps like Telegram, email, WhatsApp, Discord, Slack, Signal, and X. A personal agent mode turns Polyrob into something more durable. In this mode it keeps a backlog of goals that survives a restart, schedules its own recurring tasks using plain language like every monday at 9am, wakes itself up to check on unfinished work, and writes new skills based on what worked before. Skills follow an open format also used by Claude Code, so they can be installed from a folder, a GitHub repo, or a direct link, with a review step before anything new takes effect. For tools, it can fetch web pages as clean text, or use full browser automation for clicking and navigating real sites. It can connect to Model Context Protocol servers, pull structured data from many websites, handle files and code, and even reason over screenshots and images. The project requires Python 3.11 or later and installs with pipx. It is released under the MIT license, which allows free use including commercial use. The full README is longer than what was shown.

Yoink these prompts

Prompt 1
Show me how to install Polyrob with pipx and set up my first goal.
Prompt 2
Explain how to turn on Polyrob's personal agent mode and what it changes.
Prompt 3
Help me connect Polyrob to Telegram so I can message it tasks.
Prompt 4
Walk me through installing a skill for Polyrob from a GitHub repo.

Frequently asked questions

wtf is polyrob?

A self hosted AI agent that runs on your own machine, plans and carries out goals, and learns from past sessions.

What language is polyrob written in?

Mainly Python. The stack also includes Python, SQLite, Playwright.

What license does polyrob use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is polyrob to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polyrob for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.