{"_id":"@elizaos/plugin-groq-root","_rev":"4-7326bef7730f459abd5a2bf32e6bacdb","name":"@elizaos/plugin-groq-root","dist-tags":{"next":"2.0.0-alpha.1","latest":"2.0.0-alpha.1"},"versions":{"2.0.0-alpha.1":{"name":"@elizaos/plugin-groq-root","version":"2.0.0-alpha.1","keywords":[],"author":{"name":"elizaOS"},"license":"MIT","_id":"@elizaos/plugin-groq-root@2.0.0-alpha.1","maintainers":[{"name":"shawticus","email":"shawmakesmagic@gmail.com"},{"name":"shakkernerd","email":"shakkerdroid@gmail.com"},{"name":"wtfsayo","email":"hi@sayo.wtf"},{"name":"odilitime","email":"janesmith@airmail.cc"},{"name":"cjft","email":"cjft@trimboli.io"}],"homepage":"https://github.com/elizaos-plugins/plugin-groq#readme","bugs":{"url":"https://github.com/elizaos-plugins/plugin-groq/issues"},"dist":{"shasum":"80481c1f6d82f63ab1d4dea2439b27c0295656bb","tarball":"https://registry.npmjs.org/@elizaos/plugin-groq-root/-/plugin-groq-root-2.0.0-alpha.1.tgz","fileCount":46,"integrity":"sha512-o040xyO8yeM2i2BK5bOZ1HWfAAQ2lhDbJFyxGy0WWLcaoW2Mok+MFeQ/VZldqQy+k+Sz/N+qHesfkhapt1jduw==","signatures":[{"sig":"MEUCIQCkkztLR/grk0MTxRPGFWCLM6sfchDvoneUgx7TX9oj8wIgP6psdHp80Hb71FpRhRrDOXNGi3NXnmER+WwvNrgQ7Uo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":230697},"main":"typescript/dist/index.js","type":"module","types":"typescript/dist/index.d.ts","exports":{".":{"types":"./typescript/dist/index.d.ts","import":"./typescript/dist/index.js","default":"./typescript/dist/index.js"},"./rust":{"import":"./rust/pkg/node/elizaos_plugin_plugin_groq.js"},"./package.json":"./package.json"},"gitHead":"05d4ca11d769db8c7f54a722ee24b2ce2b951543","scripts":{"dev":"cd typescript && bun --hot build.ts","lint":"bunx @biomejs/biome check --write ./typescript","test":"bun run test:ts && bun run test:rust && bun run test:python","build":"bun run build:ts && bun run build:rust && bun run build:python","clean":"rm -rf typescript/dist python/dist rust/target .turbo node_modules","test:ts":"cd typescript && vitest run || echo 'TypeScript tests skipped - no tests found'","build:ts":"cd typescript && bun run build.ts","lint:rust":"test -d rust && cd rust && cargo clippy --all-targets --fix --allow-dirty --allow-staged -- -D warnings && cargo fmt || echo 'Rust lint skipped'","test:rust":"test -d rust && cd rust && cargo test || echo 'Rust tests skipped'","typecheck":"tsc --noEmit -p typescript/tsconfig.json","build:rust":"test -d rust && cd rust && cargo build --release || echo 'Rust build skipped - no rust directory'","lint:check":"bunx @biomejs/biome check ./typescript","lint:python":"test -d python && cd python && ruff check --fix . && ruff format . || echo 'Python lint skipped'","test:python":"test -d python && cd python && pytest -p no:anchorpy --asyncio-mode=auto || echo 'Python tests skipped'","build:python":"test -d python && cd python && (python3 -m build 2>/dev/null || pyproject-build) || echo 'Python build skipped - no python directory'","lint:python:fix":"test -d python && cd python && ruff check --fix . && ruff format . || echo 'Python lint fix skipped'"},"_npmUser":{"name":"shawticus","email":"shawmakesmagic@gmail.com"},"repository":{"url":"git+https://github.com/elizaos-plugins/plugin-groq.git","type":"git"},"_npmVersion":"lerna/9.0.3/node@v22.20.0+arm64 (darwin)","agentConfig":{"pluginType":"elizaos:plugin:1.0.0","pluginParameters":{"GROQ_API_KEY":{"type":"string","required":true,"sensitive":true,"description":"Groq API key"},"GROQ_BASE_URL":{"type":"string","default":"https://api.groq.com/openai/v1","required":false,"description":"Custom API base URL"},"GROQ_TTS_MODEL":{"type":"string","default":"playai-tts","required":false,"description":"TTS model name"},"GROQ_TTS_VOICE":{"type":"string","default":"Chip-PlayAI","required":false,"description":"TTS voice name"},"GROQ_LARGE_MODEL":{"type":"string","default":"llama-3.3-70b-versatile","required":false,"description":"Large model name"},"GROQ_SMALL_MODEL":{"type":"string","default":"llama-3.1-8b-instant","required":false,"description":"Small model name"}}},"description":"Groq LLM plugin for elizaOS - Fast inference with Llama, Qwen, and other models.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.3.5","typescript":"^5.9.3","@types/node":"^25.0.3","@biomejs/biome":"^2.3.11"},"peerDependencies":{"@elizaos/core":"2.0.0-alpha.1"},"_npmOperationalInternal":{"tmp":"tmp/plugin-groq-root_2.0.0-alpha.1_1769033828245_0.7474898941871457","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-01-21T22:17:08.129Z","modified":"2026-06-16T05:14:35.764Z","2.0.0-alpha.1":"2026-01-21T22:17:08.396Z"},"bugs":{"url":"https://github.com/elizaos-plugins/plugin-groq/issues"},"author":{"name":"elizaOS"},"license":"MIT","homepage":"https://github.com/elizaos-plugins/plugin-groq#readme","keywords":[],"repository":{"url":"git+https://github.com/elizaos-plugins/plugin-groq.git","type":"git"},"description":"Groq LLM plugin for elizaOS - Fast inference with Llama, Qwen, and other models.","maintainers":[{"email":"shawmakesmagic@gmail.com","name":"shawticus"},{"email":"janesmith@airmail.cc","name":"odilitime"}],"readme":"# @elizaos/plugin-groq\n\nGroq LLM plugin for elizaOS - Fast inference with Llama, Qwen, and other models.\n\nThis plugin provides Groq API integration for elizaOS agents, enabling ultra-fast text generation, audio transcription, and text-to-speech synthesis.\n\n## Features\n\n- 🚀 **Fast Inference** - Leverage Groq's LPU for industry-leading inference speeds\n- 📝 **Text Generation** - Generate text with Llama, Qwen, and other models\n- 🎤 **Audio Transcription** - Transcribe audio with Whisper models\n- 🔊 **Text-to-Speech** - Generate speech with PlayAI voices\n- 🔢 **Object Generation** - Generate structured JSON objects\n- 🎯 **Tokenization** - Tokenize and detokenize text\n\n## Multi-Language Support\n\nThis plugin is available for three languages:\n\n| Language              | Package                | Registry                                                  |\n| --------------------- | ---------------------- | --------------------------------------------------------- |\n| TypeScript/JavaScript | `@elizaos/plugin-groq` | [npm](https://www.npmjs.com/package/@elizaos/plugin-groq) |\n| Python                | `elizaos-plugin-groq`  | [PyPI](https://pypi.org/project/elizaos-plugin-groq/)     |\n| Rust                  | `elizaos-plugin-groq`  | [crates.io](https://crates.io/crates/elizaos-plugin-groq) |\n\n## Installation\n\n### TypeScript/JavaScript (npm)\n\n```bash\nnpm install @elizaos/plugin-groq\n# or\nbun add @elizaos/plugin-groq\n```\n\n### Python (PyPI)\n\n```bash\npip install elizaos-plugin-groq\n```\n\n### Rust (crates.io)\n\n```bash\ncargo add elizaos-plugin-groq\n```\n\n## Usage\n\n### TypeScript\n\n```typescript\nimport { groqPlugin } from \"@elizaos/plugin-groq\";\n\n// Add to your agent's plugins\nconst agent = new Agent({\n  plugins: [groqPlugin],\n});\n```\n\n### Python\n\n```python\nfrom elizaos_plugin_groq import GroqClient, GenerateTextParams\n\nasync with GroqClient(api_key=\"your-api-key\") as client:\n    response = await client.generate_text_large(\n        GenerateTextParams(prompt=\"What is the nature of reality?\")\n    )\n    print(response)\n```\n\n### Rust\n\n```rust\nuse elizaos_plugin_groq::{GroqClient, GenerateTextParams};\n\n#[tokio::main]\nasync fn main() -> anyhow::Result<()> {\n    let client = GroqClient::new(\"your-api-key\", None)?;\n\n    let response = client.generate_text_large(GenerateTextParams {\n        prompt: \"What is the nature of reality?\".to_string(),\n        ..Default::default()\n    }).await?;\n\n    println!(\"{}\", response);\n    Ok(())\n}\n```\n\n## Configuration\n\nSet the following environment variables:\n\n| Variable           | Required | Default                          | Description           |\n| ------------------ | -------- | -------------------------------- | --------------------- |\n| `GROQ_API_KEY`     | Yes      | -                                | Your Groq API key     |\n| `GROQ_BASE_URL`    | No       | `https://api.groq.com/openai/v1` | Custom API base URL   |\n| `GROQ_SMALL_MODEL` | No       | `llama-3.1-8b-instant`           | Model for small tasks |\n| `GROQ_LARGE_MODEL` | No       | `llama-3.3-70b-versatile`        | Model for large tasks |\n| `GROQ_TTS_MODEL`   | No       | `playai-tts`                     | Text-to-speech model  |\n| `GROQ_TTS_VOICE`   | No       | `Chip-PlayAI`                    | TTS voice name        |\n\n## Model Capabilities\n\nThis plugin provides handlers for the following elizaOS model types:\n\n| Model Type              | Description                                     |\n| ----------------------- | ----------------------------------------------- |\n| `TEXT_SMALL`            | Fast text generation with smaller models        |\n| `TEXT_LARGE`            | High-quality text generation with larger models |\n| `OBJECT_SMALL`          | JSON object generation (small)                  |\n| `OBJECT_LARGE`          | JSON object generation (large)                  |\n| `TRANSCRIPTION`         | Audio transcription with Whisper                |\n| `TEXT_TO_SPEECH`        | Speech synthesis with PlayAI                    |\n| `TEXT_TOKENIZER_ENCODE` | Tokenize text to tokens                         |\n| `TEXT_TOKENIZER_DECODE` | Detokenize tokens to text                       |\n\n## Development\n\n### Building from Source\n\n```bash\n# TypeScript\nbun install\nbun run build\n\n# Rust\ncd rust && cargo build --release\n\n# Python\ncd python && pip install -e \".[dev]\"\n```\n\n### Running Tests\n\n```bash\n# TypeScript\nbun run test\n\n# Rust\ncd rust && cargo test\n\n# Python\ncd python && pytest\n```\n\n### Linting\n\n```bash\n# TypeScript\nbun run format:check\n\n# Rust\ncd rust && cargo clippy\n\n# Python\ncd python && ruff check .\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Links\n\n- [elizaOS Documentation](https://elizaos.ai/docs)\n- [Groq Console](https://console.groq.com)\n- [Groq API Documentation](https://console.groq.com/docs)\n","readmeFilename":"README.md"}