https://github.com/sysread/groq.pl
A simple perl script using the Groq API and chain-of-thought reasoning to generate LLM completions.
https://github.com/sysread/groq.pl
Last synced: 2 months ago
JSON representation
A simple perl script using the Groq API and chain-of-thought reasoning to generate LLM completions.
- Host: GitHub
- URL: https://github.com/sysread/groq.pl
- Owner: sysread
- License: mit
- Created: 2025-02-08T23:21:39.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-08T23:25:17.000Z (3 months ago)
- Last Synced: 2025-02-09T00:23:06.511Z (3 months ago)
- Language: Perl
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# README
A perl script to interact with the Groq API using a chain-of-thought reasoning strategy.
This script sends prompts to the Groq API and receives responses.
It supports multiple rounds of thinking and can format the output using `glow` if installed.
## Installation
1. Make sure `perl` is installed on your system and is at least version `v5.14` (check with `perl -v`).
2. Set your Groq API key as an environment variable: `export GROQ_API_KEY='your_api_key_here'`.
3. Make the script executable: `chmod +x groq`
4. Optionally install [glow](https://github.com/charmbrace/glow) for formatted output.
## Example Usage
List available models:
```bash
groq --models
```
Send a query:
```bash
groq --query "What is the meaning of life?"
```
Specify a different model:
```bash
groq --query "What is the airspeed velocity of an unladen swallow?" --model "deepseek-r1-distill-llama-70b"
```
Specify the number of thinking rounds:
```bash
groq --query "What is the meaning of life?" --rounds 5
```
Pipe multiple queries:
```bash
echo -e "What is the meaning of life?\nWhat is the airspeed velocity of an unladen swallow?" | groq
```
Include a file in the prompt:
```bash
groq --query "Walk me through the behavior of this script." --file ./groq
```
List conversations:
```bash
groq --conversations
```
Continue a conversation:
```bash
$ groq -q "What is the airspeed velocity of an unladen swallow?"
Save conversation? [y/N] y
Saved conversation: deadbeef
$ groq -c deadbeef -q "Yes, sorry, I did mean African."
```
## Dependencies
- Perl v5.14 or higher
- [glow](https://github.com/charmbrace/glow) (optional; for formatted output)
## Environment Variables
- `GROQ_API_KEY`: Your Groq API key.
## License
This project is licensed under the MIT License.