Pickle-Bot

Your own AI assistant. Name it. Talk to it. Teach it things. Important fact Pickle is a standard little cat.

Pickle-bot is a yet another lightweight version of Openclaw.

The project started with the mindset of building-you-own-openclaw, but end up staying on my raspberry PI, dealing with all daily manners.

Installation

# From PyPI
pip install pickle-bot

# Or from source
git clone https://github.com/zane-chen/pickle-bot.git
cd pickle-bot
uv sync

Quick Start

uv run pickle-bot init      # First run: meet your new companion
uv run pickle-bot chat      # Start chatting
uv run pickle-bot server    # Run background tasks (crons, Telegram, Discord)

The first run guides you through setup. Pick your LLM, configure your agent, and you're ready.

Features

• Multi-Agent AI - Create specialized agents for different tasks (Pickle for general chat, Cookie for memories, or build your own)
• Web Tools - Search the web, read pages, do research
• Skills - Teach your agent new tricks by writing markdown files
• Cron Jobs - Schedule recurring tasks and reminders
• Memory System - Your agent remembers things across conversations
• Multi-Platform - CLI, Telegram, Discord - same agent, different places
• HTTP API - Let Pickle write a frontend for you

Documentation

• Configuration - Full config reference
• Features - How to use each feature
• Architecture - How it works under the hood

Fun Facts

Why Naming Agents with These Names?

Pickle is my cat, as mentioned at the beginning. She is really talktive, definitely more than you can think about.

Cookie was her Step brother, but he lives somewhere else now. so he manage memories on behalf of Pickle.

She's your Cat, Why Matters to Me?

Create your own agents by dropping a file in agents/{name}/AGENT.md. Give them a name, a personality. Give them skills.

Development

uv run pytest           # Run tests
uv run black .          # Format code
uv run ruff check .     # Lint

Docker

Use init command to populate workspace, and mount that as a volume.

docker compose up -d

License

MIT