selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

pinchy logo

Self-host pinchy

v0.9.1

Self-hosted AI agent platform with scoped permissions

BetaOpen CoreAGPL-3.0
Updated13 hours ago
LanguageTypescript
Setup difficultyModerate
Stars
191
RAM
4 GB
Port
7777 (Web UI, API, WebSocket bridge)
Requires
PostgreSQL 17 with pgvector
Docker
ghcr.io/heypinchy/pinchy
Install with Docker Compose
Pinchy chat interface — a team member talking to a scoped AI agentPinchy audit trail — signed, tamper-evident event logPinchy agent permissions — allow-list of tools and directories

What is pinchy?

Pinchy wraps the OpenClaw agent runtime into a team-ready platform. It introduces a plugin system where agents get explicitly allowed tools rather than raw shell access, role-based access with admin and member roles plus group-level agent visibility, and a cryptographically signed audit trail recording every agent action. The web interface and per-agent Telegram bots enforce the same permissions. The software works with cloud models from OpenAI, Anthropic, and Google, or runs fully offline with local models through Ollama. Connectors cover Odoo ERP with ready-made agent templates, Gmail and Microsoft 365 email, generic IMAP/SMTP, web search via Brave Search API, and knowledge-base agents limited to specific document folders. Deployment uses a single Docker Compose file pulling pre-built images from GHCR; a first-run wizard creates the admin account. The Community edition is free under AGPL-3.0; a paid Pro tier (€99/month billed yearly) adds groups, agent access control, and per-user analytics through an offline license key. The project is early (v0.9.x) with more granular roles and a plugin marketplace planned.

Should you self-host pinchy?

pinchy scores 43/100 on selfhost.directory (how scoring works) and ranks #153 of 209 in AI Agents. It has 191 GitHub stars.

It shipped 14 stable releases in the past year. The latest, v0.9.1, came out on 4 August 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Activepieces (81/100, 25 264 stars). It scores higher overall, so compare the two before you pick. See pinchy vs Activepieces side by side.

Features

  • Docker Compose Deployment
  • Domain lock
  • Email automations
  • Email integration (Gmail, Microsoft 365, IMAP/SMTP)
  • Knowledge base agents
  • Multi-model support (OpenAI, Anthropic, Google, Ollama, OpenAI-compatible)
  • Odoo ERP integration
  • Per-agent tool permissions (allow-list)
  • Role-based Access ControlGranular RBAC with custom roles on roadmap
  • Smithers onboarding agent
  • Tamper-evident audit trail
  • Telegram bot per agent
  • Usage and cost dashboardPer-user breakdown and CSV export are Enterprise features
  • Web Chat UI
  • Web search via Brave Search API

pinchy README

How to install pinchy

Install pinchy with Docker Compose

Environment variables
PINCHY_VERSION, DB_PASSWORD, BETTER_AUTH_SECRET, ENCRYPTION_KEY, AUDIT_HMAC_SECRET, PINCHY_ENTERPRISE_KEY, PINCHY_PORT, PINCHY_ADMIN_EMAIL, PINCHY_ADMIN_PASSWORD, PINCHY_TRUSTED_PROXIES

mkdir -p pinchy && cd pinchy curl -fsSL https://raw.githubusercontent.com/heypinchy/pinchy/v0.9.1/docker-compose.yml -o docker-compose.yml echo "PINCHY_VERSION=v0.9.1" > .env docker compose up -d

Open http://localhost:7777 — the setup wizard creates your admin account

Pre-built images from GHCR, no build step required

How to configure pinchy

  • AUDIT_HMAC_SECRETauto-generatedHMAC secret for audit trail signing

    HMAC secret for audit trail signing

    values: openssl rand -hex 32

  • BETTER_AUTH_SECRETauto-generatedBetter Auth session secret

    Better Auth session secret

    values: openssl rand -hex 32

  • DB_CPUS1CPU limit for PostgreSQL container

    CPU limit for PostgreSQL container

    values: Docker CPU limit

  • DB_MEM_LIMIT1gMemory limit for PostgreSQL container

    Memory limit for PostgreSQL container

    values: Docker memory limit

  • DB_PASSWORDpinchy_dev (dev only)Database password for PostgreSQL pinchy user

    Database password for PostgreSQL pinchy user

    values: openssl rand -hex 32

  • ENCRYPTION_KEYauto-generatedEncryption key for API keys at rest (AES-256-GCM)

    Encryption key for API keys at rest (AES-256-GCM)

    values: openssl rand -hex 32

  • OPENCLAW_CPUS2CPU limit for OpenClaw container

    CPU limit for OpenClaw container

    values: Docker CPU limit

  • OPENCLAW_MEM_LIMIT2gMemory limit for OpenClaw container

    Memory limit for OpenClaw container

    values: Docker memory limit

  • PINCHY_ADMIN_EMAILAdmin email for initial setup

    Admin email for initial setup

    values: email address

  • PINCHY_ADMIN_PASSWORDAdmin password for initial setup

    Admin password for initial setup

    values: password

  • PINCHY_CPUS1.5CPU limit for Pinchy web container

    CPU limit for Pinchy web container

    values: Docker CPU limit

  • PINCHY_ENTERPRISE_KEYEnterprise license key for Pro features

    Enterprise license key for Pro features

    values: license key from heypinchy.com

  • PINCHY_MEM_LIMIT1gMemory limit for Pinchy web container

    Memory limit for Pinchy web container

    values: Docker memory limit

  • PINCHY_PORT127.0.0.1:7777Host binding for the web UI (default 127.0.0.1:7777)

    Host binding for the web UI (default 127.0.0.1:7777)

    values: HOST_PORT or HOST_IP:HOST_PORT

  • PINCHY_TRUSTED_PROXIESExtra proxy CIDR ranges in front of Pinchy

    Extra proxy CIDR ranges in front of Pinchy

    values: CIDR notation (e.g. 10.0.0.0/8)

  • PINCHY_VERSIONPinned version tag for Docker images (required)

    Pinned version tag for Docker images (required)

    values: e.g. v0.9.1

pinchy releases & version history

FAQ

Is this really open source?

Yes. Pinchy's core is licensed under AGPL-3.0 with full source on GitHub. The Community edition is fully functional; a paid Pro tier unlocks team-governance features via a license key, not closed code.

Do I need to be technical to set this up?

You need to be comfortable with Docker Compose. Run one command, configure via the admin dashboard. Five minutes from zero to running agents.

Can I run this completely offline?

Yes. Pair Pinchy with a local model via Ollama, grant no external integrations, and nothing leaves your network.

How much does it cost to run AI agents?

Docker hosting is free on your own servers. API costs typically run $1 to $150/month per agent depending on model choice and usage volume.

Is OpenClaw secure enough for enterprise use?

Not on its own — OpenClaw gives agents full system access with no permission layer. Pinchy adds Docker isolation, per-agent allow-list permissions, basic RBAC, group-based visibility, and HMAC-signed audit trails. Granular RBAC and SSO/SAML are on the roadmap.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…