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.5.tar.gz (22.2 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.5-py3-none-any.whl (25.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: llm_to_cli-0.1.5.tar.gz
  • Upload date:
  • Size: 22.2 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.5.tar.gz
Algorithm Hash digest
SHA256 58eb96494f14c7d4b26f2db2538e9c162bf3fad226581d5cba63beb2ea17d6ff
MD5 ba8df38f0bd60809202a2f17ae8c1933
BLAKE2b-256 9c00810770dc7d77812fd5200fde7f011c205e70f5a42aa53bf11b3b9e0b1d2d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: llm_to_cli-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 25.8 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 16a99680167d3b76fcf8a87511a8dc3ea5718bc616449dc589c1b9a9eb2cd3ab
MD5 a9361ac487767cf0513159c1adb6f88f
BLAKE2b-256 60089744b064151b80e1147c5198c4bf915ccebc955dea43ca2358e0b1a8c9c5

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