lask 0.2.1

Ask your llm from the command line

lask

Ask LLMs right from the terminal.

Features

• CLI for multiple LLM providers (OpenAI, Anthropic, AWS Bedrock, Azure)
• Customizable models and parameters
• Minimal dependencies (requests, boto3 for AWS)
• Streaming responses
• Repl mode for interactive use, with temporary chat history
• Pipe input support

Installation

pip install lask

Usage

With OPENAI_API_KEY in your environment or in ~/.lask-config:

lask What movie is this quote from\? \"that still only counts as one\"

Or as a repl:

lask

==== Lask REPL Mode ====
Using provider: openai
Enter your prompts. Type 'exit' or 'quit' to end the session.
Press Ctrl+C to interrupt a response.

> What movie is this quote from? "that still only counts as one"
LLM response here...
> When was that movie released?

Or via pipe:

echo "What movie is this quote from? \"that still only counts as one\"" | lask

Setup

1. Get API keys from your provider:

   • OpenAI
   • Anthropic
   • AWS Bedrock (uses AWS credentials)

2. Create ~/.lask-config:

   [default]
   provider = openai  # openai, anthropic, aws, azure
   system_prompt = Always answer questions concisely.
   
   [openai]
   api_key = your-api-key-here
   model = gpt-4.1
   
   [anthropic]
   api_key = your-api-key-here
   model = claude-3-opus-20240229
   
   [aws]
   model_id = anthropic.claude-3-sonnet-20240229-v1:0
   region = us-east-1
   
   [azure]
   api_key = your-azure-api-key
   resource_name = your-resource-name
   deployment_id = your-deployment-id
   

   See examples/example.lask-config for a full example.

3. Or use environment variables:

   export OPENAI_API_KEY='your-api-key-here'
   export ANTHROPIC_API_KEY='your-api-key-here'
   # AWS uses standard AWS credentials
   export AZURE_OPENAI_API_KEY='your-api-key-here'
   

Configuration Options

Provider Selection

[default]
provider = openai  # openai, anthropic, aws, azure

Streaming

[openai]
streaming = false  # Disable streaming (true by default)

System Prompts

[default]
system_prompt = Always answer questions concisely.

[openai]
system_prompt = You are a helpful AI assistant.  # Provider-specific

Provider-Specific Settings

Each provider supports model, temperature, max_tokens, and other parameters.

See examples/example.lask-config for all options.

Development

This repo uses uv:

# Install dependencies
uv sync

# Build
uv build

# Install for development
pip install -e .

# For AWS Bedrock
pip install boto3

License

GNU General Public License v3.0 (GPL-3.0)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.