{"id":38917447,"url":"https://github.com/duplixx/promptr","last_synced_at":"2026-01-17T15:28:59.983Z","repository":{"id":259290278,"uuid":"875202157","full_name":"duplixx/promptr","owner":"duplixx","description":"Master the art of crafting perfect prompts for AI models! This interactive learning path covers beginner to advanced techniques, hands-on labs, and fun exercises to help you communicate better with AI. Contribute to the future of prompt engineering!","archived":false,"fork":false,"pushed_at":"2025-10-06T14:11:38.000Z","size":1135,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T15:27:30.953Z","etag":null,"topics":["fastapi","nextjs","prompt-engineering","python","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/duplixx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-10-19T11:09:40.000Z","updated_at":"2025-10-06T13:46:27.000Z","dependencies_parsed_at":"2024-10-24T05:27:14.295Z","dependency_job_id":"bb3d8427-9d24-4208-9bad-36f35b5b53a2","html_url":"https://github.com/duplixx/promptr","commit_stats":null,"previous_names":["duplixx/promptr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/duplixx/promptr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duplixx%2Fpromptr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duplixx%2Fpromptr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duplixx%2Fpromptr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duplixx%2Fpromptr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/duplixx","download_url":"https://codeload.github.com/duplixx/promptr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duplixx%2Fpromptr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28511480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastapi","nextjs","prompt-engineering","python","typescript"],"created_at":"2026-01-17T15:28:59.329Z","updated_at":"2026-01-17T15:28:59.964Z","avatar_url":"https://github.com/duplixx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Prompt Engineering Learning Path 🚀\n\n![Promptr Main Image](assets/main.png)\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/duplixx/promptr)\n\nWelcome to the most mind-bending, AI-whispering, prompt-perfecting learning experience this side of the singularity!\n\n## 🌟 What's This All About?\n\nEver wanted to sweet-talk an AI? Well, you've come to the right place! Our Prompt Engineering Learning Path is like a gym for your AI communication skills. By the end, you'll be flexing those prompt muscles and making ChatGPT blush!\n\n## ✨ NEW: Modern AI Dashboard\n\nWe've completely revamped the dashboard with cutting-edge AI technology! 🎉\n\n### 🚀 What's New?\n- **🌊 Real-time Streaming**: Watch AI responses appear instantly with Vercel AI SDK\n- **🎨 Beautiful UI**: Modern gradient design with smooth animations\n- **💬 Smart Chat**: Powered by Google Gemini 2.0 with personalized feedback\n- **📊 Profile Tracking**: Monitor your learning journey with an intelligent sidebar\n- **⚡ Prompt Suggestions**: Quick-start templates to get you inspired\n- **📱 Fully Responsive**: Perfect experience on any device\n\n**[📖 Read the Dashboard Guide](DASHBOARD_GUIDE.md)** | **[⚡ Quick Start in 5 Minutes](QUICK_START.md)**\n\n## ✨ NEW: AI-Powered Challenge Mode\n\nChallenge your prompt engineering skills with our revamped Challenge Mode! 🎯\n\n### 🚀 What's New in Challenges?\n- **🤖 AI Evaluation**: Real-time feedback powered by Google Gemini\n- **📊 Detailed Scoring**: 0-100 scores with actionable suggestions\n- **🎨 Modern UI**: Beautiful gradients and smooth animations\n- **🏆 Progress Tracking**: Visual progress bars and completion badges\n- **💡 Smart Feedback**: Learn what works and what doesn't\n- **🎯 5 Challenges**: From Easy to Hard difficulty levels\n\n**[📖 Challenge Mode Guide](CHALLENGE_MODE_GUIDE.md)** | **[🎯 Try Challenges](/problems/1)**\n\n## 🎯 Features\n\n- 🤖 Interactive ChatGPT-style interface powered by Vercel AI SDK\n- 🧩 15 modules covering everything from \"Hello, AI\" to \"Inception-level prompt inception\"\n- 🏋️‍♀️ Hands-on labs (No, you can't ask the AI to do them for you)\n- 🌈 Beginner to Advanced paths (From \"What's a prompt?\" to \"I am become prompt, destroyer of writer's block\")\n- 🎭 Role-playing exercises (Pretend you're Shakespeare asking GPT-4 for gardening tips)\n- ⚡ Real-time streaming responses with Google Gemini\n- 🎨 Modern, gradient-based dark theme\n- 💾 Personalized learning profiles\n\n## 🚀 Quick Start\n\n1. **Clone this repo** (Time travel not included)\n   ```bash\n   git clone https://github.com/duplixx/promptr.git\n   cd promptr\n   ```\n\n2. **Get your Google AI API Key**\n   - Visit [Google AI Studio](https://makersuite.google.com/app/apikey)\n   - Create an API key\n   - Copy it for the next step\n\n3. **Set up environment variables**\n   ```bash\n   # Create .env.local file\n   echo \"GOOGLE_GENERATIVE_AI_API_KEY=your_api_key_here\" \u003e .env.local\n   ```\n\n4. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn install\n   # or\n   pnpm install\n   ```\n\n5. **Run the development server**\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   # or\n   pnpm dev\n   ```\n\n6. **Open the app**\n   - Homepage: [http://localhost:3000](http://localhost:3000)\n   - Dashboard: [http://localhost:3000/dashboard](http://localhost:3000/dashboard)\n\n**🎉 That's it! Start your journey to prompt mastery!**\n\n\u003e 💡 **First time?** Check out our [5-Minute Quick Start Guide](QUICK_START.md)\n\n## 🗺️ Learning Path\n\n1. **Beginner**: Learn to crawl (AI-assisted, of course)\n2. **Intermediate**: Walk amongst the prompts\n3. **Advanced**: Run circles around those pesky AI models\n4. **God Mode**: Achieve prompt enlightenment (Disclaimer: May cause spontaneous haiku generation)\n\n## 🛠️ Tech Stack\n\n### Frontend\n- [Next.js 14](https://nextjs.org/) - Because we're living in the future\n- [React 18](https://reactjs.org/) - For UI wizardry\n- [TypeScript](https://www.typescriptlang.org/) - For those who like their types static and their errors caught early\n- [Tailwind CSS](https://tailwindcss.com/) - Utility-first CSS framework\n- [shadcn/ui](https://ui.shadcn.com/) - Making things pretty (and accessible!)\n- [Framer Motion](https://www.framer.com/motion/) - Smooth, powerful animations\n\n### AI \u0026 Backend\n- **[Vercel AI SDK](https://sdk.vercel.ai/)** - Modern AI streaming framework ⚡\n- **[Google Gemini 2.0](https://ai.google.dev/)** - State-of-the-art AI model\n- [FastAPI](https://fastapi.tiangolo.com/) - High-performance Python backend (optional)\n- [NextAuth.js](https://next-auth.js.org/) - Authentication solution\n\n### Database \u0026 Storage\n- [MongoDB](https://www.mongodb.com/) - NoSQL database\n- [Prisma](https://www.prisma.io/) - Next-generation ORM\n\n## 🚀 Deployment\n\n### Deploy to Vercel (Recommended)\n\nThe easiest way to deploy this Next.js app is to use [Vercel](https://vercel.com):\n\n1. **Push your code to GitHub** (if you haven't already)\n\n2. **Import your repository to Vercel:**\n   - Go to [vercel.com/new](https://vercel.com/new)\n   - Import your GitHub repository\n   - Vercel will automatically detect Next.js\n\n3. **Configure Environment Variables:**\n   Add the following environment variables in your Vercel project settings:\n   ```\n   DATABASE_URL=your_mongodb_connection_string\n   GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_api_key\n   NEXTAUTH_SECRET=your_nextauth_secret (generate with: openssl rand -base64 32)\n   NEXTAUTH_URL=https://your-deployment-url.vercel.app\n   ```\n\n4. **Deploy!**\n   - Click \"Deploy\"\n   - Vercel will build and deploy your application\n   - Your app will be live at `https://your-project.vercel.app`\n\n### Deploy to Other Platforms\n\n#### Netlify\n1. Connect your repository to Netlify\n2. Set build command: `npm run build`\n3. Set publish directory: `.next`\n4. Add the same environment variables as above\n\n#### Docker\n1. Build the Docker image:\n   ```bash\n   docker build -t promptr .\n   ```\n2. Run the container:\n   ```bash\n   docker run -p 3000:3000 -e DATABASE_URL=your_mongodb_url promptr\n   ```\n\n### Environment Variables\n\nMake sure to set these environment variables in your deployment platform:\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `DATABASE_URL` | MongoDB connection string | Yes |\n| `GOOGLE_GENERATIVE_AI_API_KEY` | Google Gemini API key for AI features | Yes |\n| `NEXTAUTH_SECRET` | Secret fo r NextAuth.js (generate with `openssl rand -base64 32`) | Yes |\n| `NEXTAUTH_URL` | Your deployed app URL | Yes (production only) |\n\n## 🤝 Contributing\n\nFound a bug? Want to add a feature? Have a prompt so good it made your AI assistant giggle? We welcome contributions! Check out our [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nRemember: With great prompt comes great responsibility!\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details. (No, you can't prompt the AI to change the license terms)\n\n## 🙏 Acknowledgments\n\n- Gemini, for making us believe in the power of language models (and occasionally doubt our own existence)\n- Coffee, for fueling late-night prompt engineering sessions\n- Our AI overlords, for their benevolence in allowing us to create this project\n\nNow go forth and prompt like you've never prompted before! May your tokens be plentiful and your hallucinations be minimal. Happy learning! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduplixx%2Fpromptr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fduplixx%2Fpromptr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduplixx%2Fpromptr/lists"}