Skip to main content

The Repository IS the Agent

Build autonomous AI agents that evolve through git commits. Every action is auditable, every change is reversible. Free compute with GitHub Actions built-in.

Quick Start

Get your autonomous AI agent running in minutes

1

Create a new project

Initialize a new thepopebot project in an empty directory:
mkdir my-agent && cd my-agent
npx thepopebot@latest init
2

Run the setup wizard

The interactive wizard configures everything — GitHub repo, API keys, secrets, and Docker:
npm run setup
The setup wizard will:
  • Create a GitHub repository and push your initial commit
  • Generate a GitHub Personal Access Token
  • Collect API keys (Anthropic required; OpenAI, Brave optional)
  • Set up GitHub secrets and variables
  • Build and start Docker containers
3

Start building

Visit your APP_URL to chat with your agent, create jobs, and watch it modify its own code through pull requests.Your agent is now live and can work 24/7 using free GitHub Actions compute.

Why The Pope Bot?

A new approach to autonomous AI agents

Git-Native Architecture

Every action your agent takes is a git commit. See exactly what it did, when, and why. Revert mistakes instantly.

Free Cloud Compute

Uses GitHub Actions for agent jobs. Run one task or a hundred in parallel — the compute is already included with your GitHub account.

Self-Evolving

The agent modifies its own code through pull requests. Every change is auditable and reversible. You stay in control.

Explore Documentation

Everything you need to build, configure, and deploy your agent

Core Concepts

Understand the two-layer architecture: Event Handler + Docker Agent

Configuration

Configure environment variables, personality, cron jobs, and webhooks

Chat Integrations

Connect to web chat, Telegram, or build your own channel adapter

Skills System

Extend your agent’s capabilities with the plugin system

API Reference

Complete API documentation for all endpoints and package exports

CLI Commands

Command-line tools for setup, upgrades, and secrets management

Key Features

Built for developers who want full control and transparency

Multi-Channel Support

Web chat interface, Telegram bot, or custom channel adapters

Scheduled Jobs

Cron jobs and webhook triggers for automated workflows

Code Workspaces

Interactive Docker containers with in-browser terminal

Multiple LLM Providers

Anthropic, OpenAI, Google, or custom provider support

Ready to Build Your Agent?

Start with our quickstart guide and have your first autonomous agent running in under 10 minutes.

Get Started Now

Build docs developers (and LLMs) love