Skip to content

solomonneas/prompt-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Prompt Library banner

Prompt Library

Your source of truth for prompt management, versioning, search, and reuse.

Python 3.9+ FastAPI 0.115 TypeScript 5.7 React 18 SQLite prompt store MIT license

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.

Quick Start

# 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 dev

Frontend runs on http://localhost:5201 | Backend API on http://localhost:5202

Features

  • 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:8b by 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

Documentation

Document Purpose
ARCHITECTURE.md Frontend/backend design, database schema, API endpoints, theming
CONFIGURATION.md Environment variables, port config, data setup

Tech Stack

  • Frontend: React 18 + TypeScript + Vite
  • Backend: FastAPI + SQLite + Pydantic
  • Embeddings: Ollama-compatible embeddings API
  • Storage: SQLite (prompts, versions, and embeddings, gitignored)

License

MIT - See LICENSE file for details

About

Dual-mode prompt management with browse/copy UI and REST API for sub-agents

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

  •  

Packages

 
 
 

Contributors