Skip to main content

simple llm based tools to access from cli

Project description

LLM-cli

A lightweight Command Line Interface (CLI) for interacting with Large Language Models (LLMs) using LiteLLM.

💡 Why This Project?

Sometimes network constraints or data limitations make it difficult to access large language models via web interfaces. This CLI provides a lightweight, flexible solution for LLM interactions directly from the terminal.

🚀 Features

  • Simple CLI Interface: Easily chat with different LLMs from your terminal
  • Input: Pipe inputs or redirect file text.
  • Multiple Chat Modes:
    • Direct single-message chat
    • Interactive chat UI with markdown rendering
    • Image support for vision-capable models
  • Flexible Configuration: Customize model, temperature, and system prompts
  • Easy Configuration Management: Update settings with a simple command
  • Sessions : Logs chat sessions, can be resumed saved chat later.

🔧 Prerequisites

  • Api keys to the llms, set api keys as environment variables

💾 Installation

  1. Via Pip
pip install llm-to-cli

Or

  1. From Repo
# Clone the repository
git clone https://github.com/tikendraw/llm-cli.git
cd llm-cli

# Install 
pip install .

🖥️ Usage

Basic Chat

  • Send a single message to an LLM:

    llm-cli chat "Hello, how are you?"
    
  • Pipe input

    echo "what is 34th prime number" | llm-cli chat
    
  • File redirection

    llm-chat chat < some_file_with_question.txt
    

Interactive Chat UI

  • Start an interactive chat session:

    llm-cli chatui
    

Image Support

  • Add image
    llm-cli chat --image path/to/image/or/url
    

Configuration

  • View current configuration:

    llm-cli config
    
  • Update configuration:

    llm-cli config model "anthropic/claude-3-haiku"
    llm-cli config temperature 0.7
    

🛠️ Commands

  • chat: Send a single message
  • chatui: Interactive chat
  • config: Manage CLI configuration
  • history: See and manage history

🤝 Contributing

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

🖹 License

The MIT one.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llm_to_cli-0.1.7.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llm_to_cli-0.1.7-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file llm_to_cli-0.1.7.tar.gz.

File metadata

  • Download URL: llm_to_cli-0.1.7.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.3 Linux/6.11.0-19-generic

File hashes

Hashes for llm_to_cli-0.1.7.tar.gz
Algorithm Hash digest
SHA256 f9fafc9870653c87476bc6042f5600014a7eb21bf281d2cd47adb0ab9cfd09a7
MD5 7d9ee819275b431a6387b91c46d9c136
BLAKE2b-256 e98cadc6fa63a2887ca44a9b907cc67332b202ca81198dd845d5d57504ef5ac3

See more details on using hashes here.

File details

Details for the file llm_to_cli-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: llm_to_cli-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 23.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.3 Linux/6.11.0-19-generic

File hashes

Hashes for llm_to_cli-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1c02aacdef63c1db7a2cabc664ad7a5637deb17c0362357df58d85b01b1b8e2e
MD5 f69a6d78764a0a40d9740bc44ce26151
BLAKE2b-256 f5c7bccc05743343a765b0d3fdf6a0d803b516bfad262a391e48883ccff40478

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page