Smart, lightweight AI agent engine.
Run locally on anything from a Raspberry Pi to a production VPS.

Docs · Report Bug · Discord

• Why profClaw
• Features
• Installation
• Deployment Modes
• Where It Runs
• Configuration
• AI Providers
• Chat Channels
• Integrations
• Architecture
• Development
• License

Most AI coding tools are either cloud-only (Cursor, Devin) or single-purpose CLIs (Aider, SWE-Agent). profClaw is different:

• Local-first - runs on your machine, your data stays local
• Multi-agent orchestration - routes tasks to the right agent (Claude, GPT, Ollama) based on capability scoring, not just round-robin
• Real task queue - BullMQ with dead letter queue, retry with backoff, priority scheduling
• Built-in project management - tickets, Kanban, sprints, burndown charts, bi-directional sync with GitHub/Jira/Linear
• 22 chat channels - talk to your AI through Slack, Discord, Telegram, WhatsApp, Teams, or 17 others
• Cost tracking - per-token budget management with alerts at 50/80/100%
• 72 built-in tools - file ops, git, browser automation, cron, web search, canvas, voice
• Mode-aware - scales from a Raspberry Pi (pico) to a full team server (pro)

No other open-source tool combines task orchestration, project management, and cost tracking in one self-hosted package.

npx profclaw onboard

This runs the zero-to-running wizard: picks your AI provider, sets up config, and starts the server.

Or install globally:

npm install -g profclaw@latest
profclaw setup
profclaw serve

docker run -d \
  -p 3000:3000 \
  -e ANTHROPIC_API_KEY=sk-ant-xxx \
  -e PROFCLAW_MODE=mini \
  ghcr.io/profclaw/profclaw:latest

git clone https://github.com/profclaw/profclaw.git
cd profclaw
cp .env.example .env
docker compose up -d

Want free local AI? Add Ollama:

docker compose --profile ai up -d

curl -fsSL https://raw.githubusercontent.com/profclaw/profclaw/main/install.sh | bash

profClaw scales from a Raspberry Pi to a full production server:

Set via PROFCLAW_MODE=pico|mini|pro environment variable.

profClaw requires Node.js 22+. For bare-metal embedded devices (ESP32, Arduino), see MimiClaw (C) or PicoClaw (Go).

The setup wizard (profclaw setup) handles everything interactively. Or set environment variables:

# AI Provider (pick one)
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
OLLAMA_BASE_URL=http://localhost:11434

# Deployment
PROFCLAW_MODE=mini
PORT=3000

# Optional
REDIS_URL=redis://localhost:6379   # Required for pro mode

See .env.example for all options.

35 providers with 90+ model aliases:

src/
  adapters/       AI agent adapters (tool calling, streaming)
  chat/           Chat engine + execution pipeline
    providers/    Slack, Discord, Telegram, WhatsApp, WebChat, ...
    execution/    Tool executor, sandbox, agentic loop
  core/           Deployment modes, feature flags
  integrations/   GitHub, Jira, Linear webhooks
  queue/          BullMQ (pro) + in-memory (pico/mini) task queue
  providers/      35 AI SDK providers
  skills/         Skill loader and registry
  mcp/            MCP server (stdio + SSE)
  types/          Shared TypeScript types

ui/src/           React 19 + Vite dashboard (mini/pro only)
skills/           Built-in skill definitions

git clone https://github.com/profclaw/profclaw.git
cd profclaw
pnpm install
cp .env.example .env
pnpm dev

See CONTRIBUTING.md for full guidelines.

See SECURITY.md for our security policy and how to report vulnerabilities.

AGPL-3.0