Transform Raw Prompts into AI Gold

Promptheus uses advanced AI to transform your basic prompts into polished, effective queries that get superior results from any LLM. From vague ideas to precise instructions.

Read Documentation MCP Server Install CLI View on GitHub

Alchemical Intelligence

Just as ancient alchemists transformed base metals into gold, Promptheus transforms your raw ideas into refined, powerful prompts.

Multi-Provider Support

Works with Google Gemini, OpenAI, Anthropic Claude, Groq, Qwen, and GLM. No vendor lock-in - transform prompts for any AI system.

Intelligent Questioning

Automatically asks clarifying questions to understand your intent, then crafts the perfect prompt with all the right details.

Multiple Output Styles

Choose from bullets, steps, plain text, or concise formats. Get your refined prompt in the style that best suits your needs.

Powerful CLI Interface

Built for developers and power users with keyboard shortcuts, command history, and seamless pipe integration.

Beautiful Web Interface

Experience prompt enhancement in a modern, alchemical-themed web UI with smooth animations and intuitive controls.

MCP Server Integration

Built-in Model Context Protocol server for seamless integration with AI toolchains and MCP-compatible clients.

History & Session Management

Track your prompt evolution with built-in history. Load previous refinements and build on your best work.

Witness the Transformation

See how Promptheus transforms simple prompts into powerful, detailed instructions.

Before & After Examples

❌ Basic Prompt

Write a story about a dragon who loses its fire and has to find it again.

✅ Transformed Prompt

Create a 1000-word fantasy story about Ember, a young dragon who accidentally loses their fire-breathing ability after a magical storm. Include themes of perseverance, self-discovery, and unlikely friendships. The story should have three distinct acts: 1) The accident and Ember's despair, 2) A journey through the forest to find the lost flame, 3) The emotional climax where Ember realizes true power comes from within.

🔮 Promptheus Web Interface

Enter your raw prompt:
"Help me write an email to my boss"

✨ AI Analysis:
• Purpose: Professional communication
• Audience: Manager/supervisor
• Context: Workplace setting

🎯 Clarifying Questions:
• What's the purpose of the email?
• What tone should we use?
• Any specific topics to include?

The Alchemical Process

Four simple steps to transform your raw ideas into AI gold.

1

Gather Raw Materials

Start with your basic idea or rough prompt. No need for perfect phrasing - just your raw intention.

2

Apply AI Heat

Our intelligent AI analyzes your intent and asks clarifying questions to understand exactly what you want to achieve.

3

Transmutation

The alchemical transformation begins. We refine your concept, add structure, and craft a precise, effective prompt.

4

Extract the Gold

Receive your polished prompt ready for any AI. Better clarity, better results - the transformation is complete.

Supported AI Providers

Transform prompts for any AI system. No vendor lock-in here.

🔵 Google Gemini
🟢 OpenAI
🦉 Anthropic Claude
⚡ Groq
🌙 Qwen
🤖 GLM

MCP Server Integration

Built-in Model Context Protocol server for seamless integration with AI toolchains and MCP-compatible clients.

🚀 Quick Start

promptheus mcp
  • Start server with single command
  • Connect via MCP-compatible clients
  • Call tools using standard MCP protocol
  • Handle clarifications interactively
  • Integrate with AI toolchains

🛠 Available Tools

  • refine_prompt - Intelligent prompt refinement
  • tweak_prompt - Surgical prompt modifications
  • list_models - Provider model discovery
  • list_providers - Configuration status checking
  • validate_environment - Environment validation

🎯 Use Cases

  • AI toolchain integration
  • Batch prompt processing
  • Custom AI workflows
  • Development automation
  • Automated prompt optimization pipelines
  • Multi-model prompt testing

How It Works

  1. Connect: Start the MCP server with promptheus mcp
  2. Discover: Use list_providers to check available AI providers
  3. Refine: Call refine_prompt with your basic prompt
  4. Integrate: Use the refined prompt with your AI toolchain

🔄 Two Integration Modes

Interactive Mode: When AskUserQuestion is available, questions are asked automatically.

Structured Mode: Returns clarification questions for client-side handling.

Get Started in Minutes

Install Promptheus and start transforming your prompts today.

Quick Installation

pip install promptheus

Usage Examples

# Basic usage promptheus "Write a poem about AI" # Skip questions promptheus -s "Explain quantum computing" # Interactive mode promptheus # Different providers promptheus --provider gemini "Create a marketing plan"

  • Step 1: Install Python

    Ensure you have Python 3.8+ installed. Check with:

    python --version

  • Step 2: Install Promptheus

    Install the package using pip:

    pip install promptheus

  • Step 3: Set Up API Keys

    Add your API keys to environment variables:

    export OPENAI_API_KEY="your-key"

  • Step 4: Start Transforming

    Run Promptheus and watch your prompts transform:

    promptheus "Your prompt here"