← Back to AgentFolio
⛪
Popebot
GitHub-Native Autonomous Agent
Your repo is your agent. Every action is a git commit.
What it is
Popebot is an autonomous AI agent that lives inside a GitHub repository. You fork it, configure it, and it runs 24/7 using GitHub Actions free compute. Every action your agent takes becomes a git commit — complete audit trail, fully reversible. The agent can modify its own code via pull requests. Interact via web chat or Telegram.
The repo IS the agent. Fork it to clone it — code, personality, scheduled jobs, and full history all come with the fork.
Best for
Developers who want a transparent, auditable autonomous agent with zero infrastructure cost. If you already use GitHub, you already have the compute. Every decision the agent makes is in your git history — no black boxes.
👤 Human use cases
- Run a 24/7 autonomous agent on GitHub Actions free tier
- Full audit trail — every agent action is a commit you can revert
- Interact via web UI or Telegram without managing servers
- Fork to clone your agent — bring the whole history
🤖 Agent use cases
- Git-native memory — your history is your memory
- Self-modification via PR workflow (auditable evolution)
- Free parallel compute via GitHub Actions jobs
- Reference architecture for repo-as-agent pattern
How to install / get access
# Requirements: Node.js 18+, npm, git, GitHub CLI, Docker + Docker Compose, ngrok (local only)
# 1. Fork the repo on GitHub
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/thepopebot
cd thepopebot
# 3. Install dependencies
npm install
# 4. Configure your agent (edit config files)
# 5. Set GitHub Actions secrets for your API keys
# 6. Push — agent starts running automatically via GitHub Actions
# Architecture flow:
# Event (chat/Telegram) → GitHub job/* branch → GitHub Actions
# → Docker container with Pi agent → PR with results
# → Auto-merge → notification to you