POLARIS-CLI
POLARIS-CLI is a high-performance, autonomous command-line interface agent designed for developers. Engineered for speed and precision, it leverages the Groq LPU™ Inference Engine to execute complex multi-step reasoning, filesystem operations, and terminal tasks with near-instant responsiveness.
Key Features
- Autonomous Reasoning: Employs a ReAct (Reasoning and Action) loop to solve complex tasks using integrated tools.
- Intelligent Model Routing: Automatically classifies tasks to utilize the most efficient model, ranging from lightweight 8B models to flagship 120B+ architectures.
- Native Vision Support: Seamlessly processes local image files (PNG, JPG, WebP) using state-of-the-art multimodal vision models.
- Resilient API Client: Features automatic key rotation and sophisticated error handling for high-availability performance.
- Secure Configuration: Implements OS-native secure storage for API credentials with restricted file permissions.
- Premium Terminal UI: Minimalist, branded interface featuring real-time status indicators and syntax-highlighted output.
Installation
Install the package directly from source or via pip:
pip install polaris-agent
Getting Started
Initial Configuration
Upon first execution, POLARIS-CLI will launch an interactive wizard to configure your Groq API keys.
polaris-cli setup
Basic Interaction
Enter an interactive multi-turn session to chat with the agent:
polaris-cli chat
Or execute a single one-off task:
polaris-cli "Write a python script that analyzes the current directory"
Available Commands
| Command | Description |
|---|---|
chat |
Enter the interactive, stateful multi-turn session. |
keys |
Manage and rotate your Groq API keys. |
setup |
Launch the first-run configuration wizard. |
reset |
Securely clear all local configuration and cached keys. |
help |
Display the branded help interface and usage guide. |
Autonomous Toolset
POLARIS-CLI provides the agent with a suite of low-level system capabilities:
- Filesystem:
read_file,write_file, andls_dirfor direct file manipulation. - System:
run_cmdfor terminal execution andsys_get_infofor environment awareness. - Search:
search_codefor fast, recursive grep-style regex searching across the codebase.
Intelligent Model Routing
The agent dynamically routes tasks to specialized models based on complexity and intent:
- Flagship Logic:
openai/gpt-oss-120b(System Architecture) - Deep Reasoning:
qwen/qwen3-32b(Complex Coding & Math) - Heavy Generation:
llama-3.3-70b-versatile(Long-form content) - Native Vision:
meta-llama/llama-4-scout-17b-16e-instruct(Multimodal analysis) - Light Execution:
llama-3.1-8b-instant(Greetings & Terminal commands)
License
Distributed under the MIT License. See LICENSE for more information.
Created with ❤️ by akmalriyas
Metadata
Release files for polaris-agent 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| polaris_agent-0.1.0.tar.gz | 14.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| polaris_agent-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.4 kB
Release files / polaris_agent-0.1.0.tar.gz
| Download URL | polaris_agent-0.1.0.tar.gz |
|---|---|
| Size | 14.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f5ad4588f2160433c9e25474708af934c0c978bd11d563ed47243ecf0446d865
|
|
BLAKE2b-256 checksum How to use checksums |
a1eeb9cb25b7b480e66992caed6bfb844a5559b47e8f4872b1377f43074eab06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Release files / polaris_agent-0.1.0-py3-none-any.whl
| Download URL | polaris_agent-0.1.0-py3-none-any.whl |
|---|---|
| Size | 19.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f4e1b82e10d434c88eba50ac28b2ad832a261acf9c5f6a1d9c436471af5216b8
|
|
BLAKE2b-256 checksum How to use checksums |
74f732c654469029864375984eefb9c7cf372a88673ddf125851a6a8fcb43845
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Security for polaris-agent 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.