Skip to main content

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, and ls_dir for direct file manipulation.
  • System: run_cmd for terminal execution and sys_get_info for environment awareness.
  • Search: search_code for 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)

Source distribution for polaris-agent 0.1.0
File Size Uploaded Provenance
polaris_agent-0.1.0.tar.gz 14.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for polaris-agent 0.1.0
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page