explaingit

leducbse/prometheus-ai

1TypeScriptAudience · vibe coderComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Web app that rewrites short user prompts into longer model-tailored ones for Claude, ChatGPT, Gemini, Grok, Mistral, and Perplexity. Bring your own API key, stored only in the browser.

Mindmap

mindmap
  root((prometheus-ai))
    Inputs
      Short prompts
      Provider API key
      Optional files
    Outputs
      Structured rewritten prompt
      Model-specific formatting
    Use Cases
      Improve Claude XML prompts
      Target Gemini multimodal
      Scope research prompts
    Tech Stack
      Next.js
      TypeScript
      Tailwind
      Framer Motion
      Zod

Things people build with this

USE CASE 1

Rewrite a rough prompt into a model-tailored version for Claude or Gemini

USE CASE 2

Pick from sixty use case subcategories for code, research, marketing, or learning prompts

USE CASE 3

Self-host the app on Vercel, Railway, or Fly.io with no env file

USE CASE 4

Attach text, PDF, or image files alongside a prompt for richer rewrites

Tech stack

Next.jsTypeScriptTailwindFramer MotionZodVitest

Getting it running

Difficulty · easy Time to first run · 5min

Node.js 18 or newer; API keys are entered in the browser instead of an env file.

MIT lets anyone use, copy, modify, and redistribute the code as long as the original copyright notice stays.

In plain English

Prometheus AI is a web application that takes a short, rough prompt from the user and rewrites it into a longer, more structured prompt aimed at a specific AI model. The README frames the problem as people writing prompts the way they write text messages, vague and missing context, and then being disappointed by the results. The app tries to fix that by applying prompt engineering rules automatically. The user supplies their own API key for an AI provider. The key is kept in the browser, not on any server, and the app does not require a sign up or store data on its side. Supported providers listed in the README include OpenRouter, Anthropic Claude, OpenAI, Mistral, and Google AI. OpenRouter is suggested as a way to reach many models through a single key. When rewriting a prompt, Prometheus AI tailors the output to the target model. The README spells out different focuses per model, such as XML structure and explicit constraints for Claude, direct task framing for ChatGPT, multimodal clarity for Gemini, stable prefixes for Grok, compact instructions for Mistral, and research scoping for Perplexity. The user can also pick from ten use case categories, including text, image, code, websites and apps, AI agents, research, marketing, learning, and documents. Each category has more specific subcases, with the README claiming over sixty in total. Files such as text documents, PDFs, and images can be attached alongside the prompt. The project is a Next.js 16 application written in TypeScript, with Tailwind CSS for styling, Framer Motion for animation, Zod for validation, and Vitest for tests. The README shows a directory layout where the prompt engineering logic lives under apps/web/lib/transform, with files for a rule compiler, provider API calls, intent detection, model configurations, and use case definitions. Running it locally needs Node.js 18 or newer. The README gives the standard clone, npm install, and npm run dev steps, with the app available at localhost:3000. No environment file is needed because the API key is entered in the browser. For production it can be deployed to Vercel, Railway, Render, Fly.io, Coolify, or any Node compatible host. The license is MIT.

Copy-paste prompts

Prompt 1
Run prometheus-ai locally with npm install and npm run dev and point it at my OpenRouter key
Prompt 2
Walk me through the rule compiler under apps/web/lib/transform and how intent detection works
Prompt 3
Add a new model profile to the providers list with custom rewrite focus
Prompt 4
Deploy prometheus-ai to Coolify with a single command
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.