Skip to main content

🐈 PipClaw: Ultra-Lightweight, Pure Python Agent.

Project description

🐈 PipClaw

The Ultra-Lightweight, Pure Python Kernel for AI Agents.

Home: https://github.com/CrawlScript/pipclaw

Python 3.8+

PipClaw is a minimalist, 100% Pure Python autonomous agent kernel. While frameworks like OpenClaw offer great power, they often introduce heavy dependencies like Node.js, Docker, or complex C-extensions.

PipClaw strips away the complexity, offering a crystal-clear, readable architecture that serves as both a production-ready kernel and a comprehensive tutorial on building modern AI agents.


🌟 Key Features

  • 100% Pure Python: No C-extensions, no Node.js, no Docker. If you have Python, you have PipClaw.
  • Minimalist & Readable: A "Batteries-Included" architecture designed to be a living tutorial. Learn how to build an OpenClaw-style agent by reading code, not documentation.
  • Highly Customizable Kernel: Designed as a core engine, not a rigid app. Easily plug in your own logic, state management, and custom tools.
  • Universal Cross-Platform: Runs seamlessly on Windows, macOS, Linux, and minimalist environments like Raspberry Pi.
  • Multi-Channel Interaction: Built-in support for interacting with your agent via Telegram, WhatsApp, and more—all handled through pure Python integrations.

🚀 Quick Start

No compiling, no heavy setup. Just pip and run.

pip install pipclaw
pipclaw run

🛠 The Philosophy

The trend in AI agents is moving towards massive complexity. PipClaw moves towards clarity. Most developers don't need a 400,000-line black box. They need a reliable, auditable kernel that handles the agent loop and tool-calling while remaining light enough to be modified in minutes. PipClaw is the "distilled essence" of an autonomous bot.

🔌 Connectors

PipClaw allows you to interact with your agent through multiple channels:

  • Terminal Mode: Standard interactive CLI (default).
  • Telegram Mode: No external dependencies. Just create a bot via @BotFather and provide your token during setup.
  • WhatsApp Mode: Requires Node.js (v22.17.0 recommended) to run the lightweight bridge. The agent will show a QR code in your terminal for linking.
# To change your mode or LLM settings
pipclaw config

📂 Project Structure

pipclaw/
├── kernel/          # Core agent loop & state logic
├── connectors/      # Telegram, WhatsApp, and Web UI bridges
├── providers/       # LLM connectors (OpenAI, Anthropic, etc.)
└── tools/           # Extensible toolset (Search, Code Exec, etc.)

Developed with ❤️ for the Python community. Let's keep it simple.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pipclaw-0.0.7.tar.gz (26.9 kB view details)

Uploaded Source

File details

Details for the file pipclaw-0.0.7.tar.gz.

File metadata

  • Download URL: pipclaw-0.0.7.tar.gz
  • Upload date:
  • Size: 26.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for pipclaw-0.0.7.tar.gz
Algorithm Hash digest
SHA256 39caa90dddedc1a46f699ecc3bc73f9cb95e7181e9809c6170b090a653880861
MD5 acc9bd3da4f91083f3ebd8766bda7437
BLAKE2b-256 f58ae77a601d2fa658d4c0f42c033e72562321c77fad3a3711f3e6196722f6eb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page