# GroqShell
Welcome to **GroqShell**, a powerful command-line interface designed for seamless interaction with Groq AI models. With GroqShell, you can effortlessly send prompts to Groq models and receive instant responses right in your terminal.
## 🌟 Features
- **Command-Line Interaction**: Engage with Groq AI models directly from your terminal.
- **Model Selection**: Choose from a variety of available Groq models.
- **JSON Output**: Easily force JSON output for structured responses.
- **Persistent Model Selection**: Your selected model is remembered for future sessions.
- **Interactive Mode**: Enjoy a continuous conversation with the AI.
- **Markdown Formatting**: Responses are beautifully formatted in Markdown.
- **Syntax Highlighting**: Code blocks are highlighted for better readability.
- **Command History Support**: Navigate through your command history effortlessly.
## 🚀 Installation
To get started with GroqShell, follow these simple steps:
1. Install the package using pip:
```bash
pip install groqshell-cli
```
## Usage
Before using **GroqShell**, make sure to set your **Groq API key** as an environment variable:
```
export GROQ_API_KEY='your-api-key-here'
```
**Basic usage:**
```
groqshell -p "Your prompt here"
```
**Force JSON output:**
```
groqshell -p "Your prompt here" -j
```
**Select a different Groq model:**
```
groqshell -m
```
**List available Groq models:**
```
groqshell -l
```
**Enter interactive mode:**
```
groqshell -I
```
## 🔍 Options
- `-p`, `--prompt`: The prompt to send to the Groq AI model (required)
- `-j`, `--json`: Force JSON output
- `-c`, `--change`: Change the Groq model
- `-i`, `--info`: Get information about the currently selected model
- `-l`, `--list`: List available Groq models
- `-I`, `--interactive`: Enter interactive mode for continuous conversation
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📜 License
This project is licensed under the MIT License.
Raw data
{
"_id": null,
"home_page": null,
"name": "groqshell",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, groq, ai, cli, shell, interface",
"author": "Revaz Goguadze",
"author_email": "<goguadze.rezi2022@gmail.com>",
"download_url": null,
"platform": null,
"description": "\n# GroqShell\n\nWelcome to **GroqShell**, a powerful command-line interface designed for seamless interaction with Groq AI models. With GroqShell, you can effortlessly send prompts to Groq models and receive instant responses right in your terminal.\n\n## \ud83c\udf1f Features\n\n- **Command-Line Interaction**: Engage with Groq AI models directly from your terminal.\n- **Model Selection**: Choose from a variety of available Groq models.\n- **JSON Output**: Easily force JSON output for structured responses.\n- **Persistent Model Selection**: Your selected model is remembered for future sessions.\n- **Interactive Mode**: Enjoy a continuous conversation with the AI.\n- **Markdown Formatting**: Responses are beautifully formatted in Markdown.\n- **Syntax Highlighting**: Code blocks are highlighted for better readability.\n- **Command History Support**: Navigate through your command history effortlessly.\n\n## \ud83d\ude80 Installation\n\nTo get started with GroqShell, follow these simple steps:\n\n1. Install the package using pip:\n\n ```bash\n pip install groqshell-cli\n ```\n\n## Usage\n\nBefore using **GroqShell**, make sure to set your **Groq API key** as an environment variable:\n\n```\nexport GROQ_API_KEY='your-api-key-here'\n```\n\n**Basic usage:**\n\n```\ngroqshell -p \"Your prompt here\"\n```\n\n**Force JSON output:**\n\n```\ngroqshell -p \"Your prompt here\" -j\n```\n\n**Select a different Groq model:**\n\n```\ngroqshell -m\n```\n\n**List available Groq models:**\n\n```\ngroqshell -l\n```\n\n**Enter interactive mode:**\n\n```\ngroqshell -I\n```\n\n## \ud83d\udd0d Options\n\n- `-p`, `--prompt`: The prompt to send to the Groq AI model (required)\n- `-j`, `--json`: Force JSON output\n- `-c`, `--change`: Change the Groq model\n- `-i`, `--info`: Get information about the currently selected model\n- `-l`, `--list`: List available Groq models\n- `-I`, `--interactive`: Enter interactive mode for continuous conversation\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## \ud83d\udcdc License\n\nThis project is licensed under the MIT License.\n",
"bugtrack_url": null,
"license": null,
"summary": "Command-line interface for Groq AI models",
"version": "0.0.21",
"project_urls": null,
"split_keywords": [
"python",
" groq",
" ai",
" cli",
" shell",
" interface"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fdac4b16c9a06dabab4b09fc5a62be1301c81e4c10cf6b6cfa9bf6cba5cd96db",
"md5": "cf67042680c4b3ea64dddbf38cf0edd2",
"sha256": "5e63d2b6bd6313e8a2cf589b16a192904a8a692574b8ac44520779a9141d0403"
},
"downloads": -1,
"filename": "groqshell-0.0.21-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cf67042680c4b3ea64dddbf38cf0edd2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4993,
"upload_time": "2024-10-25T18:05:40",
"upload_time_iso_8601": "2024-10-25T18:05:40.743258Z",
"url": "https://files.pythonhosted.org/packages/fd/ac/4b16c9a06dabab4b09fc5a62be1301c81e4c10cf6b6cfa9bf6cba5cd96db/groqshell-0.0.21-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-25 18:05:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "groqshell"
}
JSON