Metadata-Version: 2.4
Name: groq-ai-cli
Version: 1.0.0
Summary: Ask AI anything, right from your terminal — powered by Groq
License: MIT
Project-URL: Homepage, https://github.com/yourusername/groq-ai-cli
Project-URL: Issues, https://github.com/yourusername/groq-ai-cli/issues
Keywords: cli,ai,groq,llm,terminal,assistant
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# ⚡ groq-ai-cli

Ask AI anything, right from your terminal — powered by [Groq](https://groq.com).

```
ai how do I find all files larger than 1GB?
ai explain what chmod 755 does
ai write a bash for loop that renames all .txt files to .md
```

Responses stream instantly with syntax-highlighted code blocks, colored bullets, and bold headings — all rendered natively in your terminal.

---

## Install

```bash
pip install groq-ai-cli
```

## Setup

On first run, you'll be prompted to enter your Groq API key and choose a model:

```bash
ai "hello"
```

Or run setup manually anytime:

```bash
ai --config
```

Get a **free** API key at [console.groq.com](https://console.groq.com).

---

## Usage

```bash
ai <your question>
ai --config       # change API key, model, or system prompt
ai --version      # show version
ai --help         # show help
```

## Config

Settings are stored in `~/.config/groq-ai-cli/config.json`. You can also set `GROQ_API_KEY` as an environment variable — it takes priority over the config file.

## Available Models

| Model | Speed | Best for |
|-------|-------|----------|
| `llama-3.3-70b-versatile` | Fast | General use (default) |
| `llama-3.1-8b-instant` | Fastest | Quick lookups |
| `mixtral-8x7b-32768` | Fast | Long context |

## License

MIT
