Conquer your creative block. Turn vague ideas into battle-ready AI execution plans.
Welcome to PromptHelper — your friendly AI architect that helps you go from "I have a fuzzy idea" to "Here's exactly what to do, which tool to use, and how to prompt it." Whether you're brand new to AI tools or a seasoned developer looking to save time, we've got you covered.
PromptHelper is a free, open-source web application that:
- Takes your rough ideas — even super vague ones like "I want to build a cute page for my DIY blog but I don't know code"
- Refines them through conversation — asking smart questions to understand what you really need
- Selects the perfect AI tool from a database of 68+ platforms (ChatGPT, Claude, Cursor, Bolt, v0, Gemini, and more)
- Generates an optimized prompt — tailored to that specific tool
- Creates an actionable plan — step-by-step guidance on how to execute
Think of it as having an experienced AI consultant who knows which tool is best for what, and how to get the most out of each one.
If you're just starting your journey with AI tools and feeling overwhelmed by all the options, PromptHelper is your guide. We help you:
- Discover which tool to use for your specific project
- Learn how to prompt effectively without the trial-and-error frustration
- Get pointed in the right direction with clear, beginner-friendly plans
Example Use Case:
"I want to build a cute page for my DIY blog but I don't know code"
→ We'll ask about your design preferences, skill level, and goals
→ Then recommend v0.dev or Bolt.new with a perfectly crafted prompt
→ Plus a step-by-step plan to get your site live
If you're already experienced with AI but want to save time on prompt engineering for specific tasks, PromptHelper streamlines your workflow:
- Get optimized prompts instantly for specialized tasks
- Leverage our tool knowledge to pick the right platform for niche use cases
- Speed up project setup with pre-architected plans
Example Use Case:
"I need an optimized prompt for an LLM to audit and improve my current UI and routing"
→ We'll analyze your tech stack and preferences
→ Recommend Claude with Code Projects or Cursor with specific settings
→ Deliver a sophisticated prompt covering UX patterns, accessibility, performance, and routing best practices
- Node.js 20+ installed
- npm, yarn, pnpm, or bun
-
Clone the repository
git clone https://github.com/lightmyfireadmin/PromptHelper.git cd PromptHelper/my-prompt-architect -
Install dependencies
npm install
-
Set up environment variables Create a
.env.localfile with your API key:OPENROUTER_API_KEY=your_openrouter_api_key_here
Get a free API key at openrouter.ai/keys
-
Run the development server
npm run dev
-
Open your browser Navigate to http://localhost:3000
The easiest way to deploy is via Vercel:
- Push your code to GitHub
- Import the repo in Vercel
- Add your
OPENROUTER_API_KEYenvironment variable - Deploy!
PromptHelper uses a three-phase workflow:
- You describe your project in natural language
- Our AI asks clarifying questions to understand your:
- Technical skill level
- Project complexity
- Specific requirements
- Preferences (UI style, speed vs. quality, etc.)
- Runs a sophisticated filtering algorithm ("Sniper Scope") over 68+ AI tools
- Scores each tool based on:
- Your project requirements
- Tool capabilities (reasoning, coding, speed, ease of use)
- Cost and availability
- Presents the best match with clear explanations
- Generates a highly optimized prompt for your chosen tool
- Creates a step-by-step execution plan
- Includes best practices, pitfalls to avoid, and pro tips
| Category | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript |
| Styling | Tailwind CSS v4 + Shadcn/UI |
| State | Zustand |
| AI Gateway | OpenRouter (Llama 3.3 70B, DeepSeek R1) |
src/
├── app/
│ ├── api/architect/ # API routes
│ │ ├── chat/ # Conversation handler
│ │ ├── select/ # Tool selection logic
│ │ └── plan/ # Plan generation
│ └── page.tsx # Main wizard UI
├── components/
│ ├── landing/ # Landing page sections
│ ├── wizard/ # Tool reveal & plan display
│ └── chat/ # Chat interface
├── data/
│ ├── tools_database.json # 68 AI tools catalog
│ └── best_practices.json # Prompting strategies
├── lib/
│ └── api/openrouter.ts # OpenRouter client
└── store/
├── wizard.ts # Wizard state
└── chat.ts # Chat state
We use OpenRouter as our AI gateway, which provides access to top free-tier models:
- Primary: Llama 3.3 70B Instruct (free)
- Fallback: DeepSeek R1 (free)
This lets us serve requests without hitting paywalls. During peak times you might experience slight delays as models queue.
We have exciting features on the roadmap:
- 🏗️ GitHub Repository Integration — context-aware suggestions based on your codebase
- 📊 Prompt Library — community templates you can fork and customize
- 🎨 Advanced Customization — fine-tune selection criteria and save preferences
- 🔗 API Access — integrate PromptHelper into your development tools
Want to help build these features? Check our issues page!
We LOVE contributions! Here's how you can help:
- 🐛 Report bugs — Open an issue with reproduction steps
- 💡 Suggest features — Tell us what would make PromptHelper more useful
- 📝 Improve documentation — Fix typos, clarify instructions, add examples
- 🧑💻 Submit code — Fix bugs, add features, improve performance
- 🗄️ Update the tool database — Add new AI tools in
src/data/tools_database.json
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes and test (
npm run build) - Commit with clear messages
- Open a Pull Request
- No user data collection — We don't store your prompts or conversations
- No tracking — No analytics, no cookies, no surveillance
- Open source — Inspect our code anytime
MIT — Free to use, modify, and distribute.
Built with:
- Next.js — React framework
- OpenRouter — AI gateway (Llama 3.3, DeepSeek R1)
- Tailwind CSS — Styling
- shadcn/ui — UI components
- Zustand — State management
Made with ❤️ by the open source community
⭐ Star this repo if you find it helpful!