Hermit — a skill registry for discovering, publishing, and managing AI agent skills
概览
Private, self-hosted skill registry server — ClawHub-compatible, with Repository Trio semantics. hermit is a lightweight registry that lets teams AI agent skills behind their own infrastructure. It speaks the same API as ClawHub, so any compatible CLI or client works out of the box. Every hermit instance bootstraps three repository types that work together: - Go 1.24 + Echo v4 - PostgreSQL 16 - Local filesystem or S3/MinIO blob store - React 19 + TypeScript + Tailwind CSS 4 + daisyUI 5 (bundled SPA) This starts both and the (with the web frontend bundled in). The database schema is auto-applied on first run. Once ready, open http://localhost:8080 in your browser. Override settings via environment variables in docker-compose.yml or by mounting a .env file. See .env.example for the full list. The frontend dev server runs on http://localhost:5173 and proxies /api requests to the backend.
README
以下为原文 README 节选，完整内容请查看原文。
Hermit
Private, self-hosted skill registry server — ClawHub-compatible, with Repository Trio semantics.
Overview
hermit is a lightweight registry that lets teams publish, proxy, and discover AI agent skills behind their own infrastructure. It speaks the same API as ClawHub, so any compatible CLI or client works out of the box.
Repository Trio
Every hermit instance bootstraps three repository types that work together:
| Type | Role |
|---|---|
| Hosted | Private publish target — your first-party skills live here. |
| Proxy | Lazy-caching mirror of one or more upstreams (e.g. ClawHub). Fetches on first hit, then serves from local cache. |
| Group | Unified read endpoint that merges Hosted + Proxy. All catalog read APIs go through Group. |
Tech Stack
- Go 1.24 + Echo v4
- PostgreSQL 16
- Local filesystem or S3/MinIO blob store
- React 19 + TypeScript + Tailwind CSS 4 + daisyUI 5 (bundled SPA)
Getting Started
docker compose up -d
This starts both PostgreSQL and the hermit server (with the web frontend bundled in). The database schema is auto-applied on first run.
Once ready, open http://localhost:8080 in your browser.
Default credentials:
| Value | |
|---|---|
| Admin UI login | admin / changeme123 |
| Admin API token | dev-admin-token |
Configuration
Override settings via environment variables in docker-compose.yml or by mounting a .env file. See .env.example for the full list.
Development (without Docker)
# 1. Start Postgres only
docker compose up -d postgres
# 2. Copy and edit environment config
cp .env.example .env
# 3. Run the Go server
go run ./cmd/server
# 4. Run the frontend dev server (in another terminal)
cd web && pnpm install && pnpm dev
The frontend dev server runs on http://localhost:5173 and proxies /api requests to the backend.
Features
Skill Catalog
- Full-text search across skill names, display names, and summaries.
- Paginated skill listing with cursor-based pagination.
- Sortable by: updated, downloads, stars, installs (current / all-time), trending.
- Skill detail with file explorer, syntax-highlighted source preview, and rendered Markdown.
- Side-by-side unified diff between any two versions (added / removed / modified files with line-level changes).
- Chronological version history with changelogs.
Publishing
- Publish skill versions via multipart upload. Each version is an immutable zip archive; republishing the same
slug + versionreturns409 Conflict. SKILL.mdmanifest required. Files are sorted, archived, and stored with per-file SHA-256 descriptors.- Tag support (
latestis always set; additional custom tags can be provided).
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add hermit-labs/hermit