Priompt overview
Priompt is a prompt server: it stores, versions, and validates your AI prompts, serves each one by its address, and tells every agent the moment a prompt changes.
A prompt edit can break an agent in production, and without history nobody can say what the old prompt was. Priompt gives prompts what git gives code: every change is a commit, and you can always roll back. It's for teams that run agents and want prompt changes to be reviewed, versioned, and delivered like code.
Priompt is at v0.7.4. The server image, both SDKs, and the Go modules are published under Apache-2.0. See Status and roadmap for what's done and what's missing.
Get started
What Priompt adds
Priompt adds two things that git can't do for prompts:
- Semantic diff: Priompt scores what an edit means, from a harmless rewording to a structural change that rewires how the prompt behaves. See Semantic diff.
- Live distribution: Agents hear about a change the moment it's published, with that verdict attached. They can reload safe edits on their own and hold risky ones for a person. See Live updates.
| Code has | Prompts get |
|---|---|
| A git server | A Priompt server |
| A file path | A prompt address, such as priompt://acme/onboarding/welcome |
| Commits and branches | Commits and branches, per prompt |
git diff | A semantic diff that says whether the meaning changed, and how far |
| Deploys | A change event to every subscribed agent |
You run the server, so your prompts stay in your infrastructure. Agents in any language fetch prompts by address instead of hard-coding them.
How it fits together
The diagram shows who writes prompts, where Priompt stores them, and how agents read them and hear about changes.
See How Priompt works for the request flow and the ports.
Components
You only need the server. Everything else is optional.
| Component | What it does | Docs |
|---|---|---|
priompt | The server. It stores, versions, validates, and serves prompts over gRPC, and embeds a NATS broker for change events. The same binary is the ops CLI. Image: ghcr.io/priompt/priompt. | Install, CLI |
promptctl | The authoring tool. Prompts live as files in a git repo, are validated and diffed before they ship, and publish in one step. | Author prompts in git |
priompt-auth | Exchanges an SSO login or a service-account secret for a short-lived JWT that the server verifies offline. | SSO and service accounts |
| Python SDK | priompt-sdk on PyPI, imported as priompt_sdk. Get, list, diff, and subscribe, with an optional local cache. | Python SDK |
| Node SDK | @priompt/client on npm. Get, diff, publish, and subscribe, with no code generation. | JavaScript SDK |
| Web UI | A browser app to browse prompts, history, and diffs, and to edit prompts. | Web UI overview |
proto | The Go module github.com/priompt/proto: the gRPC API, JWT claims, validation rules, and the semantic diff engine. | Change the contract |
db-adapters | The Go module github.com/priompt/db-adapters: the storage engine for SQLite and PostgreSQL. | Storage engine |
The web UI shows a prompt with the slots Priompt detected in it:
Next steps
- Quickstart: run a server and watch a change arrive.
- Use cases: see the problems teams solve with Priompt.
- Install Priompt: pick Docker or a native service.