https://github.com/cyberytti/promptwriter
promptWriter is a CLI tool that helps users create and refine high-quality AI prompts efficiently. It automates polishing ideas and generating structured, optimized prompts, simplifying prompt engineering. Designed for both technical and non-technical users, it streamlines the process, making AI interaction more effective and accessible.
https://github.com/cyberytti/promptwriter
Last synced: 4 months ago
JSON representation
promptWriter is a CLI tool that helps users create and refine high-quality AI prompts efficiently. It automates polishing ideas and generating structured, optimized prompts, simplifying prompt engineering. Designed for both technical and non-technical users, it streamlines the process, making AI interaction more effective and accessible.
- Host: GitHub
- URL: https://github.com/cyberytti/promptwriter
- Owner: cyberytti
- License: gpl-3.0
- Created: 2025-03-10T19:56:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-10T20:02:21.000Z (over 1 year ago)
- Last Synced: 2025-10-22T04:59:23.413Z (8 months ago)
- Size: 17.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PromptWriter π
**A Modern CLI Tool for Crafting AI Prompts**
```
P R O M P T W R I T E R
------------------------
> Crafting AI Prompts <
------------------------
[===> ] Loading...
[======> ] Refining...
[========] Done!
```
[](https://opensource.org/licenses/MIT)
[]()
[](https://github.com/username/promptwriter/actions)
---
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Acknowledgments](#acknowledgments)
---
## Overview π
PromptWriter is a streamlined command-line interface (CLI) tool designed to simplify the art of prompt engineering. Whether you're a developer, writer, or AI enthusiast, PromptWriter helps you craft high-quality, optimized prompts for AI models with ease. By automating the refinement and generation process, it transforms raw ideas into polished, AI-ready promptsβsaving time and ensuring consistency. Say goodbye to tedious manual editing and hello to efficient, effective AI interactions!
---
## Features
- π **Two-Step Smart Processing**:
- Refines your input for grammar, clarity, and intent.
- Generates structured, best-practice prompts for AI systems.
- π οΈ **User-Friendly CLI**: Simple commands with optional verbose mode for transparency.
- π **Real-Time Progress Tracking**: Animated spinners and updates during processing.
- β‘ **AI-Powered Backend**: Leverages advanced models like Mistral 24B and Qwen-QwQ-32B via the Groq API.
---
## Installation π οΈ
Follow these steps to get PromptWriter up and running on your system.
### Prerequisites
- **OS**: Windows, macOS, or Linux
- **Python**: Version 3.8 or higher
- **Pip**: Python package manager
- **Groq API Key**: Sign up at [Groq](https://groq.com) to obtain your API key.
### Steps
1. Clone the repository:
```bash
git clone https://github.com/username/promptwriter.git
cd promptwriter
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Set up your Groq API key:
```bash
export GROQ_API_KEY="your-api-key-here"
```
4. Verify installation:
```bash
promptwriter --version
```
**Edge Case**: Ensure your internet connection is active, as PromptWriter relies on the Groq API for processing.
---
## Usage π
PromptWriter is designed to be intuitive. Hereβs how to start crafting prompts:
### Basic Command
```bash
promptwriter craft --idea "Write a poem about summer"
```
### Verbose Mode (Optional)
See the step-by-step process:
```bash
promptwriter craft --idea "Write a poem about summer" --verbose
```
Output example:
```
Original: "Write a poem about summer"
Refined: "Compose a poem describing the essence of summer."
Final Prompt: "Generate a well-structured poem capturing the warmth, vibrancy, and spirit of summer, with clear imagery and a consistent tone."
```
For more details, check the [documentation](docs/README.md).
---
## Examples π
### Use Case 1: Creative Writing
**Input**:
```bash
promptwriter craft --idea "Tell a story about a lost astronaut"
```
**Output**:
"Create a narrative about an astronaut stranded in space, exploring themes of isolation and resilience, with vivid descriptions and a compelling conclusion."
### Use Case 2: Data Analysis
**Input**:
```bash
promptwriter craft --idea "Analyze sales data"
```
**Output**:
"Perform a detailed analysis of sales data, identifying trends, key insights, and actionable recommendations, presented in a clear and concise format."
---
## Contributing π€
We welcome contributions from the community! To get involved:
1. **Fork the Repository**: Click "Fork" on GitHub.
2. **Create a Branch**: `git checkout -b feature/your-feature-name`
3. **Submit a Pull Request**: Follow our [PR template](CONTRIBUTING.md#pull-requests).
4. **Report Issues**: Use the [Issues tab](https://github.com/username/promptwriter/issues).
Please review our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
---
## License π
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
[](https://opensource.org/licenses/MIT)
---
## Contact βοΈ
Have questions or feedback? Reach out to us:
- **Email**: promptwriter-support@example.com
- **Twitter**: [@PromptWriterHQ](https://twitter.com/PromptWriterHQ)
- **GitHub Issues**: [Report a bug](https://github.com/username/promptwriter/issues)
---
## Acknowledgments π
- **Groq API**: For powering our AI backend.
- **Mistral 24B & Qwen-QwQ-32B**: State-of-the-art models for refinement and generation.
- **Open-Source Community**: For inspiration and support.
---