rcarmo/piclaw

Registry 信息

项目简介

Piclaw 是一个自托管的 AI 编程代理，使用 TypeScript 和 Bun 构建，可在隔离的 Docker 工作区中运行，并支持 VNC 访问。它利用 LLM 和自适应卡片提供交互式、基于浏览器的编码环境。

要点

• 基于 Bun 运行时的自托管 AI 编程代理
• 隔离的 Docker 工作区，确保安全执行
• VNC 访问，支持可视化环境交互
• 自适应卡片，提供丰富的交互式界面
• 基于 Web 的界面，便于管理
• 支持多种 LLM 后端

使用场景

• 在隔离环境中自动生成和审查代码
• 通过 VNC 提供可视化反馈的交互式编程辅助
• 用于私有或敏感项目的自托管 AI 代理
• 在 AI 指导下学习编程的教育工具
• 在一次性工作区中快速原型设计和实验

README 摘要

# `piclaw` — your self-hosted AI workspace  PiClaw packages the [Pi Coding Agent](https://github.com/badlogic/pi-mono) into a self-hosted workspace with a streaming web UI, persistent state, multi-provider LLM support, and a practical built-in toolset that includes [many add-ons](https://rcarmo.github.io/piclaw-addons/). It is for people who want one stateful agent workspace they can run locally or in a container without stitching together half a dozen separate services. ## Why PiClaw  - **One workspace, one app** — chat, editor, terminal, viewers, boards, uploads, and automation in the same web UI - **Persistent state** — SQLite-backed messages, media, tasks, token usage, encrypted keychain, and session-scoped SSH / Proxmox / Portainer profiles - **Practical built-ins** — code editing, Office/PDF/CSV/image/video viewing, draw.io, VNC, browser automation, image processing, MCP, infra tools, and optional cross-instance IPC for paired remote peers - **Agent-first workflows** — steering, queued follow-ups, side prompts, autoresearch loops, scheduled tasks, and visual artifact generation - **Context conservation** — small always-active tool baseline with staged discovery via `list_tools` / `list_scripts` - **Optional auth/channels** — passkeys/TOTP for the web UI, plus optional WhatsApp integration ## Quick start ```bash mkdir -p ./home ./workspace docker run -d \ --init \ --name piclaw \ --restart unless-stopped \ -p 8080:8080 \ -e PICLAW_WEB_PORT=8080 \ -v "$(pwd)/home:/config" \ -v "$(pwd)/workspace:/workspace" \ ghcr.io/rcarmo/piclaw:latest ``` Open `http://localhost:8080` and type `/login` to configure your LLM provider, including custom OpenAI-compatible endpoints when you are not us

话题