Pranor Documentation
Welcome to the Pranor documentation. Pranor is a unified, modular backend infrastructure engine with its own programming language, designed to build high-performance microservices with zero glue code.
💡 Documentation Version Selector
- 📘 Pranor v1.0 (Stable Docs) — Core 16 Infrastructure Modules (Gate, Pulse, Vault, Auth, Mesh, etc.)
- 🚀 Pranor v2.0 (AI Execution Fabric Docs) — Governed AI Agent Execution Layer (
std/graph,std/decision,std/agent,std/memory,std/eval,std/flow)
Quick Navigation
| Section | Description |
|---|---|
| Getting Started | Install Pranor and build your first service in 5 minutes |
| Language Reference | Syntax, standard library, CLI commands |
| Module Docs | Full documentation for each Pranor module |
| Deployment | Docker, Kubernetes, standalone deployment guides |
| Architecture | System design, security model, observability |
| Enterprise | EE features, licensing, and comparison |
| Changelog | Unified release history |
Modules
| Module | What it does | Docs |
|---|---|---|
| Pranor (CLI) | Compiler & language runtime | Language → |
| Gate | API Gateway & AI Guard | gate.md → |
| Pulse | Async Event Broker & Message Queue | pulse.md → |
| Vault | S3 Storage & Vector Search | vault.md → |
| Chrono | Distributed Job Scheduler | chrono.md → |
| Auth | Identity & Access Control | auth.md → |
| Cache | Distributed Cache Engine | cache.md → |
| Mesh | Service Discovery & Load Balancing | mesh.md → |
| Trace | Distributed Tracing Engine | trace.md → |
| Console | Observability Dashboard | console.md → |
| Pool | Database Connection Proxy | pool.md → |
| Notify | Email/Slack/SMS Gateway | notify.md → |
| Flow | Workflow Engine & Saga Orchestrator | flow.md → |
| Deploy | Docker/K8s Deployment Pipeline | deploy.md → |
| Tunnel | WebSocket Dev Tunneling | tunnel.md → |
| Hub | Package Registry | hub.md → |
| Lock | Distributed Locking | lock.md → |
| Secret | Secret Management | secret.md → |
Install
# macOS/Linux
brew tap vyuvaraj/pranor && brew install pranor
# Windows
scoop bucket add pranor https://github.com/vyuvaraj/scoop-pranor
scoop install pranor
# From source
git clone https://github.com/vyuvaraj/pranor && cd pranor/lang && go build -o pranor .
First Service
pranor init myapp && cd myapp && pranor run main.pnr --watch
v2.0 AI Execution Fabric (v2.0-dev — merges post v1.0 release)
Pranor v2.0 extends the ecosystem with a governed AI agent execution layer built on top of the existing infrastructure. All v2.0 modules are CGO-free (CGO_ENABLED=0) and follow the OSS/EE build-tag convention.
| Module | Path | Description |
|---|---|---|
| Pranor Graph | std/graph | Virtual entity context assembly — Hot/Warm/Cold 3-tier with fail-closed contract |
| Pranor Decision | std/decision | 6-level priority veto ladder: Auth > Budget > Risk > Rules > Learn > Default |
| Pranor Learn | std/learn | Pluggable ML inference provider (wazero WASM + gRPC sidecar) |
| Pranor Eval | std/eval | Trajectory replay and quality scoring — 4 evaluators (accuracy, latency, cost, safety) |
| Trace Schema | std/trace | Canonical OTLP span hierarchy + mandatory attribute contract for all modules |
| Flow AgentStep | std/flow | AgentStep interface + Saga runner + HITL approval queue |
Branch: All v2.0 features live on
v2.0-dev. See v2.0 modules docs for full API reference.