Lokumerie is a self-hosted private package registry for team AI know-how.
It gives collaborating teams a private place to publish, version, search, install, and curate the prompts, Codex or Claude-style skill folders, runbooks, source notes, and hard-won lessons that help a project get smarter over time.
AI teams accumulate useful instructions everywhere: local skill folders, Slack messages, pull request comments, notes, and one-off prompts. Lokumerie gives that knowledge a home with:
- Versioned skills with markdown and bundled folder support.
- A terminal CLI for pushing, searching, listing, and installing skills.
- Koutis, which are curated collections of skills for a project, role, or workflow.
- A pantry for links, notes, references, and source material.
- Authenticated team access through Auth.js OAuth providers.
- Optional semantic search with pgvector and Gemini embeddings.
- Next.js App Router
- React
- Prisma
- PostgreSQL with pgvector
- Auth.js / NextAuth
- Tailwind CSS
Requirements:
- Node.js 22+
- PostgreSQL with the
vectorextension available - A GitHub or Google OAuth app
npm install
cp .env.example .env
npx prisma migrate dev
npm run devOpen http://localhost:3000.
Generate an auth secret with:
npx auth secretFor local OAuth callbacks, use:
http://localhost:3000/api/auth/callback/github
http://localhost:3000/api/auth/callback/google
After signing in, open Settings and copy the generated CLI install command. For local development it looks like:
curl -sL http://localhost:3000/lokum.sh | LOKUM_API_KEY=lok_xxx bash -s -- setupThe CLI supports:
lokum push skill.mdlokum push path/to/skill-folderlokum listlokum search "deploy"lokum install teammate-skill-sluglokum versions teammate-skill-sluglokum loginlokum logoutlokum whoami
For a deployed instance, set NEXT_PUBLIC_APP_URL in the app and LOKUM_URL in the CLI environment if needed.
Copy .env.example and fill in:
DATABASE_URLAUTH_SECRETAUTH_GITHUB_IDandAUTH_GITHUB_SECRET, orAUTH_GOOGLE_IDandAUTH_GOOGLE_SECRETNEXT_PUBLIC_APP_URLALLOWED_EMAILSif you want an email allowlistGOOGLE_API_KEYif you want embeddings and semantic search
npm run lint
npm run build
npx prisma studioMaintenance scripts:
npm run db:seed
npm run db:links
npm run db:reassign-flavors
npm run db:backfill-embeddingsLokumerie is a normal Next.js app backed by PostgreSQL. Use any host that supports Node.js and a Postgres database with pgvector. Run migrations during deploy:
npx prisma migrate deploy
npm run build
npm run startBuilt by David Pavlovschii.
Socials and related links:
MIT