ultraprompt

UltraPromptML (UPML) Compiler v1.0.14

Transform .upml files into hyper-efficient, LLM-optimized prompts using a unified signals engine and streamlined CLI.

v1.0.14 Update: Major performance improvements with signal caching (40-60% faster), unified API functions (62% code reduction), enhanced error diagnostics, and configurable recursion limits. Full settings documentation and schema versioning added.

🚀 Quick Start

Installation

# Install globally with npm
npm install -g ultraprompt

Usage

# Compile a .upml file to optimized .md (writes prompt.md next to input)
upml prompt.upml

# Initialize a starter template from settings
upml init

# Add/update a signal mapping (persists in src/settings.ultraprompt.json)
upml signal "UltraPromptML" UPML

# Get help and usage information  
upml --help

📝 Minimal UPML Example

SYSTEM: [ATTRIBUTE: IDENTITY] {
  <SYSTEM_PROMPT>
    NAME: "Aurora"
    AUTHOR: "TrinityAI Research"
    AXIOMATIC: "You are Aurora, a concise and helpful assistant."
    TONE: "Professional and friendly"
    CUTOFF_DATE: "2025-01-01"
    CURRENT_DATE: "${getCurrentTimestamp()}"
  </SYSTEM_PROMPT>
}

Compiles to a compact, signal-boosted form:

SYSTEM:<SP ATTB="IDT">{NM:"Aurora",AUTHOR:"TrinityAI Research",AX:"ur Aurora, a concise and helpful assistant.",TONE:"Professional and friendly",RK:"2025-01-01",CD:"${getCurrentTimestamp()}"}</SP>

🎯 Key Features

• Unified signals: Single mapping source in src/settings.ultraprompt.json drives all abbreviations.
• Aggressive application: Signals apply case-insensitively across the entire output, including inside quotes.
• Attribute system: [ ... ] prelude hoisted to the first tag as attributes using attribute_signals.
• Punctuation cleanup: Removes spaces around punctuation, and removes hyphens/apostrophes.
• Structural emphasis: Uppercases content inside <> and [] in the compiled output.
• Contractions/web-speak: Built-in mappings like you are -> ur, cannot -> cant, etc.

📊 Token Savings Example

Format	Tokens	Reduction
Original UPML	245 tokens	-
Compiled Output	89 tokens	63.7%
Manual Optimization	156 tokens	36.3%

🏗️ Configuration

• src/settings.ultraprompt.json is the single source of truth.
• Sections:
  • quickstart_template: a string containing a starter UPML template wrapped in { ... }.
  • signals: unified mapping for tags, keys, and NL terms (multi-word supported).
  • attribute_signals: mappings used when hoisting attributes from the section prelude.

CLI commands update this file as needed (e.g., upml signal “Full Form” ABBR).

📚 Documentation

For detailed UPML syntax and advanced features, see documentation.md.

Managing Signals

• Add a new mapping: upml signal "Full Term" ABBR
• Edit mappings: open src/settings.ultraprompt.json and modify signals or attribute_signals.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

• Fork the repository
• Create your feature branch (git checkout -b feature/AmazingFeature)
• Commit your changes (git commit -m 'Add some AmazingFeature')
• Push to the branch (git push origin feature/AmazingFeature)
• Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🏢 About TrinityAI

UltraPromptML is developed by TrinityAI Research, specializing in advanced LLM development.

🔗 Links

• GitHub Repository
• npm Package
• Issue Tracker
• Full Documentation