Paperclip

Paperclip is an open-source artificial intelligence (AI) coding agent platform for self-hosting Claude-based coding agents.

  • AI
  • Productivity
  • Tools & Utilities
Paperclip is an open-source artificial intelligence (AI) coding agent platform for self-hosting Claude-based coding agents. It provides a web-based interface for configuring, running, and managing AI agents. It is aimed at developers and homelab users who want a locally controlled alternative to hosted agent services. This BitCryptic image is no longer maintained as of 2026-09-20, remains available for existing installs, and requires PostgreSQL, an Anthropic API key, and public URL configuration.

Platform availability

Available on 6 of 10 platforms

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

92/100 Excellent

Maintained
100last commit 17 days ago
Popular
100111,064 GitHub stars
Easy to install
856 install platforms, install notes, Docker image
Light to run
701 GB minimum RAM

Availability: platform listings confirmed today, links checked 5 days ago

GitHub stars
111,064
Open issues
6610
Last commit
2026-11-04
Latest release
v2026.1023.0
License
MIT
Activity
unknown

Checked 17 days ago - source: GitHub (paperclipai/paperclip)

Resources & Compatibility

Minimum requirements: 1 GB RAM, 1 CPU core(s), 10 GB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Run onboarding before starting Run `paperclipai onboard` first so Paperclip creates its config, the PAPERCLIP_AGENT_JWT_SECRET (a secret token agents use to prove they belong to you) in the .env file, and a local secrets key. Without these files, the app may not start properly or agents may not be able to connect. source
  • Protect the generated secret files Keep the generated .env file and local secrets key file safe or back them up. Losing them can break trusted agent connections, and sharing them can let someone act as your Paperclip setup. source
  • Use LAN preset for other devices If you want other devices on your LAN (local area network) to reach Paperclip, run `paperclipai onboard --bind lan`. Without this, the default local setup may only answer from the machine you installed it on, so other devices cannot connect. source
  • Required environment and database setup Start a separate PostgreSQL container, set DATABASE_URL to its connection string, set BETTER_AUTH_SECRET to a securely generated random string, set ANTHROPIC_API_KEY for Claude-based agents, and set PAPERCLIP_PUBLIC_URL to the URL users will use to access Paperclip. source

Fetched 43 days ago - each note links to its source

Alternatives (2)

  • Microsoft Foundry - Platform-as-a-service on Azure unifying agents, models, and tools with tracing, monitoring, role-based access control, and support for 1,90…
  • Orbitagents - Deploy AI agents that come with tools and context wired in from the get go.

Checked 54 days ago - source: AlternativeTo

Common questions

Do I need to run onboarding before starting Paperclip?

Yes. Run paperclipai onboard first so Paperclip creates its config, the PAPERCLIP_AGENT_JWT_SECRET in the .env file, and a local secrets key. Without these files the app may not start properly or agents may not be able to connect.

How do I let other devices on my LAN access a local Paperclip install?

If other devices on your LAN should reach Paperclip, run paperclipai onboard --bind lan. Without this, the default local setup may only answer from the machine where Paperclip is installed.

How do I update a self-hosted Paperclip instance?

On a managed install, run paperclipai update or upgrade. It backs up the database, swaps the payload, hot-restarts an active service, and auto-rolls back if the new build is unhealthy. Other install types use npm, image pull, or git plus migrate.

What should I check when Paperclip agents won’t run?

Diagnose heartbeat failures, stuck runs, API auth errors, and agent pausing. These are common agent execution problems.

Does the Paperclip self-hosting guide cover reverse proxy setup?

Yes. It covers Linux setup, configuration, reverse proxy, and keeping Paperclip updated.

Answers sourced from docs.paperclip.ing, docs.paperclip.ing, paperclip.community, papercliphosting.ai, papercliphosting.ai

Community

Collected 53 days ago - public community threads