Pranor Documentation

The complete reference for the Serv ecosystem — language, components, operations, and architecture.

Getting Started

DocDescription
Getting StartedInstall Serv, write your first service, run it
Language GuideFull language tutorial — 30 sections covering all features
ExamplesCategorized code examples with explanations

Reference

DocDescription
Language ReferenceDetailed syntax specification and type system
Built-in Functionslog, db, cache, http, json, ai, store, broker
Standard Library48 importable .pnr modules (auth, jwt, retry, pagination, etc.)
CLI ReferenceAll serv commands with flags and usage

Components

DocDescription
Component CatalogAll 16 services with status, ports, and architecture
[Pranor Gate](components/Pranor Gate.md)API Gateway — WASM middleware, AI routing, MCP support
[Pranor Vault](components/Pranor Vault.md)Object Storage — S3-compatible, semantic search, time-travel
[Pranor Pulse](components/Pranor Pulse.md)Message Broker — STOMP, WASM transforms, DLQ, tiered storage
[Pranor Console](components/Pranor Console.md)Dashboard — unified observability, SQL workbench, alerting
[Pranor Mesh](components/Pranor Mesh.md)Service Mesh — library-level, mTLS, circuit breaking
[Pranor Cache](components/Pranor Cache.md)Cache — Redis/in-memory, namespacing, TTL
[Pranor Chrono](components/Pranor Chrono.md)Scheduler — leader election, cron syntax, Pranor Vault persistence
[Pranor Deploy](components/Pranor Deploy.md)Deployment — process orchestration, Docker, gateway sync
[Pranor Trace](components/Pranor Trace.md)Tracing — OTLP ingestion, waterfall UI, anomaly detection
[Pranor Tunnel](components/Pranor Tunnel.md)Tunneling — WebSocket relay, request inspection, subdomain routing
[Pranor Auth](components/Pranor Auth.md)Identity — OAuth2/OIDC, MFA, RBAC, social login
[Pranor Pool](components/Pranor Pool.md)Database Proxy — pooling, routing, query analytics
[Pranor Notify](components/Pranor Notify.md)Notifications — SMTP, Slack, SMS, templates
[Pranor Flow](components/Pranor Flow.md)Workflows — DAG execution, sagas, approval gates
[Pranor Hub](components/Pranor Hub.md)Packages — semver resolution, signing, Pranor Vault backend
ServDocsDocumentation — auto-generated from .pnr source
[Pranor Core](components/Pranor Core.md)Common Library — health probes, OTel, JWT middleware
pranor-lockctlLock CLI — distributed lock acquisition, renewal, and deadlock inspection
pranor-secretctlSecrets CLI — key rotation, secret injection, and Shamir unseal operations

v2.0 AI Execution Fabric (v2.0.0 Released — GA)

All v2.0 modules are CGO_ENABLED=0 and follow the OSS/EE build-tag convention. Available natively on main.

DocDescriptionStatus
[Pranor Graph](components/Pranor Graph.md)Virtual entity context assembly — Hot/Warm/Cold 3-tierv2.0.0 GA
[Pranor Decision](components/Pranor Decision.md)6-level AI governance veto ladderv2.0.0 GA
[Pranor Learn](components/Pranor Learn.md)Pluggable ML inference (WASM + gRPC sidecar)v2.0.0 GA
[Pranor Eval](components/Pranor Eval.md)Trajectory replay and quality scoringv2.0.0 GA
v2.0 ArchitectureFull AI Execution Fabric architecture docv2.0.0 GA

Operations

DocDescription
Deployment GuideDocker, TLS, multi-target deploy, production config
Docker Compose GuideRun the full 16-service stack locally
ArchitectureRuntime dependencies, service interactions, layers
RoadmapWhat's done, what's next, maturity matrix

Port Allocation

ServicePortProtocol
Pranor Gate8080HTTP/HTTPS
Pranor Vault8081HTTP (S3)
Pranor Pulse8082 / 61613HTTP + STOMP
Pranor Console8083HTTP
Pranor Cache8084HTTP
Pranor Chrono8085HTTP
Pranor Deploy8086HTTP
Pranor Mesh8087HTTP
Pranor Hub8088HTTP
ServDocs8089HTTP
Pranor Trace8090HTTP (OTLP)
Pranor Notify8094HTTP
Pranor Flow8096HTTP
Pranor Pool8097HTTP
Pranor Auth8098HTTP
Pranor Tunnel8443WebSocket