Your source of truth for prompt management, versioning, search, and reuse.
Your source of truth for prompt management. Browse, version, and share prompts with built-in variable substitution, instant copy-to-clipboard, and full search capabilities.
# Clone the repo
git clone https://github.com/solomonneas/prompt-library.git
cd prompt-library
# Backend setup
cd backend
pip install -r requirements.txt
uvicorn app:app --reload --host 0.0.0.0 --port 5202
cd ..
# Frontend setup
cd frontend
npm install
npm run devFrontend runs on http://localhost:5201 | Backend API on http://localhost:5202
- Expandable Cards - View full prompts inline, no click-through needed
- Copy-to-Clipboard - One-click copy on every prompt
- Version Control - Immutable history on every edit, view or restore any version
- Variable Substitution - Use
{{variables}}in prompts with live preview - Smart Filtering - Categories, tags, and full-text search
- Semantic Search - Optional Ollama embeddings with
qwen3-embedding:8bby default - 5 Visual Themes - Editorial, Warm Earthy, Clean Light, Ledger, Dark Pro
- REST API - Programmatic access for sub-agents and integrations
- Write Protection - Optional API key requirement for create, update, delete, restore, and embedding rebuild routes
- Demo Data - 8 seed prompts for fresh installs, real database gitignored
| Document | Purpose |
|---|---|
| ARCHITECTURE.md | Frontend/backend design, database schema, API endpoints, theming |
| CONFIGURATION.md | Environment variables, port config, data setup |
- Frontend: React 18 + TypeScript + Vite
- Backend: FastAPI + SQLite + Pydantic
- Embeddings: Ollama-compatible embeddings API
- Storage: SQLite (prompts, versions, and embeddings, gitignored)
MIT - See LICENSE file for details
