{"id":31581358,"url":"https://github.com/kingmuli/prompt-generator","last_synced_at":"2025-10-05T21:56:38.194Z","repository":{"id":317608136,"uuid":"1068102192","full_name":"kingmuli/Prompt-Generator","owner":"kingmuli","description":"AI Prompt Generator creates professional prompts for ChatGPT, Midjourney, DALL-E \u0026 more. Customize tone, complexity \u0026 style. Features AI-powered generation with fallback templates, copy/save options, and responsive design. Perfect for content creators \u0026 AI enthusiasts.","archived":false,"fork":false,"pushed_at":"2025-10-01T22:19:33.000Z","size":36,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-02T00:11:30.824Z","etag":null,"topics":["ai-prompt-generator","artificial-intelligence","chatgpt","chatgpt-api","content-creation","creative-writing","dalle","deepseek-r1","flask","machine-learning","midjourney","web-development"],"latest_commit_sha":null,"homepage":"https://promptpilot.opensystems.co.ke/prompt-generator.html","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kingmuli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-10-01T21:24:16.000Z","updated_at":"2025-10-01T23:54:05.000Z","dependencies_parsed_at":"2025-10-02T00:11:33.395Z","dependency_job_id":"e5baec85-b656-4c80-ba6a-e82757cb7a22","html_url":"https://github.com/kingmuli/Prompt-Generator","commit_stats":null,"previous_names":["kingmuli/prompt-generator"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kingmuli/Prompt-Generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingmuli%2FPrompt-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingmuli%2FPrompt-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingmuli%2FPrompt-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingmuli%2FPrompt-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kingmuli","download_url":"https://codeload.github.com/kingmuli/Prompt-Generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingmuli%2FPrompt-Generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278526241,"owners_count":26001326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai-prompt-generator","artificial-intelligence","chatgpt","chatgpt-api","content-creation","creative-writing","dalle","deepseek-r1","flask","machine-learning","midjourney","web-development"],"created_at":"2025-10-05T21:56:36.445Z","updated_at":"2025-10-05T21:56:38.187Z","avatar_url":"https://github.com/kingmuli.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PromptPilot API - AI Prompt Generator\n\nA full-stack web application for generating professional AI prompts for various AI models including ChatGPT, Midjourney, DALL-E, and more.\n\n## 🚀 Features\n\n- **Multi-Model Support**: Generate prompts for ChatGPT, Midjourney, DALL-E, Stable Diffusion, Claude\n- **Customizable Parameters**: Control tone, complexity, type, and additional options\n- **Smart Generation**: Uses DeepSeek AI API for intelligent prompt generation\n- **Fallback System**: Template-based fallback when AI service is unavailable\n- **Responsive Design**: Works perfectly on desktop and mobile devices\n- **Example Templates**: Pre-built templates for common use cases\n- **Export Options**: Copy to clipboard or save as text file\n\n## 📁 Project Structure\n\n```\npromptpilot-api/\n├── backend/\n│   ├── app.py                 # Flask API server\n│   └── requirements.txt       # Python dependencies\n└── frontend/\n    └── index.html            # Frontend interface\n```\n\n## 🛠️ Setup Instructions\n\n### Prerequisites\n\n- Python 3.8+\n- Flask\n- DeepSeek API account (for AI generation)\n\n### Backend Setup\n\n1. **Navigate to backend directory**:\n   ```bash\n   cd backend\n   ```\n\n2. **Create virtual environment**:\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Set environment variables**:\n   ```bash\n   export DEEPSEEK_API_KEY=\"your_deepseek_api_key_here\"\n   export PORT=5000  # Optional, defaults to 5000\n   ```\n\n5. **Run the server**:\n   ```bash\n   python app.py\n   ```\n\n### Frontend Setup\n\n1. **Update API URL**:\n   - Open `frontend/index.html`\n   - Find the `API_BASE_URL` configuration in the JavaScript section\n   - Update with your actual domain for production:\n   ```javascript\n   const API_BASE_URL = 'https://your-actual-domain.com/api';\n   ```\n\n2. **Deploy frontend**:\n   - Serve `index.html` from your web server\n   - Ensure CORS is properly configured for your domain\n\n## 🌐 Deployment\n\n### Backend Deployment (PythonAnywhere, Heroku, Railway)\n\n1. **Upload backend files** to your hosting service\n2. **Set environment variables**:\n   - `DEEPSEEK_API_KEY`: Your DeepSeek API key\n   - `PORT`: Server port (usually set automatically by hosting provider)\n\n3. **Install dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n### Frontend Deployment (Netlify, Vercel, GitHub Pages)\n\n1. **Upload frontend files** to your static hosting service\n2. **Update API endpoint URL** in `index.html`\n3. **Configure proper CORS headers** if needed\n\n## 🔧 Configuration\n\n### Environment Variables\n\n- `DEEPSEEK_API_KEY`: Required for AI-powered prompt generation\n- `PORT`: Server port (default: 5000)\n\n### CORS Configuration\n\nUpdate the allowed origins in `app.py`:\n```python\nCORS(app, origins=[\n    \"https://yourdomain.com\",\n    \"http://yourdomain.com\", \n    \"https://www.yourdomain.com\"\n])\n```\n\n## 📚 API Endpoints\n\n### `POST /api/generate-prompt`\nGenerate an AI prompt based on user parameters.\n\n**Request Body**:\n```json\n{\n  \"model\": \"chatgpt\",\n  \"type\": \"creative\",\n  \"topic\": \"Artificial Intelligence\",\n  \"tone\": \"professional\",\n  \"complexity\": 3,\n  \"include_examples\": true,\n  \"step_by_step\": false,\n  \"include_questions\": true,\n  \"custom_instructions\": \"Focus on practical applications\"\n}\n```\n\n**Response**:\n```json\n{\n  \"success\": true,\n  \"prompt\": \"Generated prompt text...\",\n  \"source\": \"ai\"\n}\n```\n\n### `GET /api/health`\nHealth check endpoint.\n\n## 🎨 Customization\n\n### Adding New AI Models\n1. Update the `model` dropdown in `index.html`\n2. Add model-specific formatting in the `build_fallback_prompt` method in `app.py`\n\n### Adding Prompt Types\n1. Update the `prompt-type` dropdown in `index.html`\n2. Add type descriptions in the `build_system_prompt` method in `app.py`\n\n## 🔒 Security Notes\n\n- Keep your DeepSeek API key secure and never commit it to version control\n- Use environment variables for all sensitive configuration\n- Implement rate limiting in production\n- Validate all user inputs on the backend\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n1. **CORS Errors**: Update the allowed origins in the Flask CORS configuration\n2. **API Key Issues**: Verify your DeepSeek API key is correctly set as an environment variable\n3. **Generation Failures**: The system will automatically fall back to template-based generation\n\n### Logs\n\nCheck the application logs for detailed error information:\n```bash\n# View logs in production\nheroku logs --tail  # For Heroku\n```\n\n## 📄 License\n\nThis project is licensed under the GNU GENERAL PUBLIC LICENSE.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n## 📞 Support\n\nFor support and questions:\n- Create an issue in the GitHub repository\n- Check the documentation at [PromptPilot](https://promptpilot.opensystems.co.ke)\n\n---\n\n**Note**: Remember to replace placeholder domains and API keys with your actual production values before deployment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingmuli%2Fprompt-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkingmuli%2Fprompt-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingmuli%2Fprompt-generator/lists"}