Prompt Compiler

Prompt Compiler turns vague requests into structured prompts, execution plans, and policy-checked workflows — so you can go from idea to safe, usable AI output in seconds.

Try it now at prcompiler.com | VS Code extension | GitHub artifacts

Type any request — a feature idea, a bug report, a research question — and Prompt Compiler produces:

• System Prompt — persona, role, constraints, output format
• User Prompt — structured task definition
• Execution Plan — step-by-step decomposition
• Expanded Prompt — ready to paste into any LLM
• Policy Layer — risk level, allowed tools, execution mode, data sensitivity

The engine analyzes your intent and produces four output layers:

• System Prompt: persona, role, constraints, and output format rules for the target AI
• User Prompt: structured task definition derived from your input
• Execution Plan: decomposed steps based on your request
• Expanded Prompt: a combined prompt ready to paste into chat-based LLMs

Switch between the output tabs in the UI to inspect each layer, and copy any result with one click.

The Conservative toggle controls how aggressively the compiler interprets your input.

The toggle is available in both the web app and the browser extension, and its state is persisted locally.

Prompt Compiler now also exposes a structured IR and policy layer for more sensitive or execution-heavy requests.

• Risk Level: low, medium, high
• Execution Mode: advice_only, human_approval_required, auto_ok
• Data Sensitivity: public, internal, confidential, restricted
• Allowed / Forbidden Tools
• Sanitization Rules

This is not a separate product. It is a new capability inside Prompt Compiler that helps you inspect risky requests before you run them downstream in coding, research, or automation flows.

Describe a role or autonomous task, and the Agent Generator produces a complete, constraint-driven system prompt for an AI agent.

• Single Agent: generates a focused, single-role agent prompt with boundary conditions
• Multi-Agent Swarm: toggle the multi-agent mode to generate a cooperative swarm-style prompt for specialized workers

After generating an agent, the Export section can turn the output into framework-ready code:

Describe a capability in plain English, and the Skill Generator translates it into a structured tool definition.

• Produces Input Schema and Output Schema in valid JSON
• Generates a stringified skill definition ready for LangChain, OpenAI functions, or custom agent frameworks

After generating a skill, the Export section can wrap the output in framework-specific code:

Compresses your prompt by roughly 20-30% without losing meaning, logic, or variables. Useful near context-window limits.

A/B test raw prompts against compiled versions:

• Raw vs. Compiled side-by-side comparison
• Auto-Judge scoring for relevance, quality, and clarity
• Visual Metrics including improvement percentages

Upload project files such as PDF, Markdown, text, or code to ground Prompt Compiler in your own domain context.

• Context Manager for drag-and-drop reference files
• Strategist/Critic flow for injecting grounded context and catching hallucinated claims
• Local SQLite-backed retrieval for fast reuse without re-uploading

Prompt Compiler can render deterministic markdown artifacts from natural language requests:

• Issue Brief
• Implementation Checklist
• PR Review Brief

Example:

python -m cli.main github render --type pr-review-brief --from-file prompt.txt

The new VS Code package lives in integrations/vscode-extension:

• PromptC: Compile Selection
• PromptC: Open Panel
• Tabs: Intent, Policy, Prompts, Raw JSON
• Settings: promptc.apiBaseUrl, promptc.conservativeMode

API keys are stored in VS Code secret storage, not workspace settings.

git clone https://github.com/madara88645/Compiler.git
cd Compiler

# Backend: pyproject.toml is the source of truth
python -m pip install -e .[dev,docs]

# Frontend
cd web
npm ci
cd ..

cp .env.example .env

Core variables:

OPENAI_API_KEY=sk-your-actual-key
OPENAI_BASE_URL=https://api.openai.com
GROQ_API_KEY=gsk_your_groq_key

# Prompt compiler mode: conservative (default) or default
PROMPT_COMPILER_MODE=conservative

# Optional auth hardening
ADMIN_API_KEY=replace-me
PROMPTC_REQUIRE_API_KEY_FOR_ALL=false

# Optional RAG storage controls
PROMPTC_UPLOAD_DIR=.promptc_uploads
PROMPTC_RAG_ALLOWED_ROOTS=

Notes:

• Leave PROMPTC_REQUIRE_API_KEY_FOR_ALL=false for backwards-compatible local development.
• /compile/fast, generator routes, and RAG mutation routes require an API key.
• If you set PROMPTC_RAG_ALLOWED_ROOTS, only files inside those roots can be ingested by path.

Windows (one-click): double-click start_app.bat

Manual:

# Terminal 1 - Backend
python -m uvicorn api.main:app --reload --port 8080

# Terminal 2 - Frontend
cd web
npm run dev

Open http://localhost:3000.

1. Type your idea, prompt, task, or workflow request into the input box.
2. Click Generate.
3. Review the output tabs: Intent, System, User, Plan, Expanded, JSON, Quality.
4. Use Conservative mode when you want grounded output.
5. If the task is sensitive, inspect the policy layer before using the result downstream.
6. Use Agent, Skill, Optimizer, Benchmark, and RAG surfaces as needed.

api/            FastAPI endpoints (compile, agent-generator, skills-generator, optimize, rag)
app/
  compiler.py       Core compiler pipeline
  emitters.py       Prompt rendering layer
  models_v2.py      IR v2 and policy contract
  llm_engine/       HybridCompiler and provider logic
  heuristics/       Offline parsing, safety, risk, and policy inference
  rag/              SQLite FTS5 RAG index and retrieval
  testing/          Regression runner
  github_artifacts.py
web/
  app/
    page.tsx                    Main compiler UI
    agent-generator/            Agent Generator page
    skills-generator/           Skill Generator page
    benchmark/                  Benchmark Playground
    optimizer/                  Token Optimizer
    components/                 Shared UI components
cli/            CLI entrypoints
integrations/
  vscode-extension/
extension/      Browser extension
tests/          Offline-safe test suite
docs/           Product, pattern, and workflow docs

• docs/pattern-library.md
• docs/promptc-safe-workflows.md
• examples/github/promptc-artifact.yml

Copyright © 2026 Mehmet Özel. All rights reserved.

Licensed under the Apache License 2.0.

For managed/hosted service inquiries: mehmet.ozel2701@gmail.com

Self-hosting is free and always will be.