Skip to main content

AI-powered Command Generator using Local LLMs

Project description

qcmd - AI-powered Command Generator

A simple command-line tool that generates shell commands using local AI models via Ollama.

Version 1.0.2

Overview

qcmd is a powerful command-line tool that generates shell commands using AI language models via Ollama. Simply describe what you want to do in natural language, and qcmd will generate the appropriate command.

Key Features

  • Natural Language Inputs: Describe what you want to do in plain English
  • Auto-fix Mode: Automatically fixes failed commands and retries
  • AI Error Analysis: Explains errors and suggests solutions
  • Interactive Shell: Continuous operation with command history
  • Multiple Models: Works with any Ollama model (default: qwen2.5-coder:0.5b)
  • Safety First: Always asks for confirmation before executing any command
  • Log Analysis: Find and analyze system log files with real-time monitoring

Installation

Prerequisites

  • Python 3.6 or higher
  • Ollama installed and running
  • At least one language model pulled (e.g., qwen2.5-coder:0.5b)

Install from PyPI

pip install ibrahimiq-qcmd

Make sure Ollama is running before using qcmd:

ollama serve

Basic Usage

# Generate and confirm a command
qcmd "list all files in the current directory"

# Auto-execute mode
qcmd -e "find large log files"

# Smart auto-fix mode
qcmd -A "find Python files modified today"

# Interactive shell
qcmd -s

What's New in 1.0.2

  • Fixed undefined variable errors in interactive shell and auto mode
  • Improved error handling and command detection for dangerous operations
  • Streamlined GitHub Actions workflow for Python 3.10 and 3.11
  • Enhanced compatibility with continuous integration systems
  • Fixed tab completion issues in interactive shell

What's New in 1.0.1

  • Updated documentation with improved installation instructions
  • Fixed package structure for better compatibility
  • Added PyPI integration for easier installation

Full Documentation

For full documentation and source code, visit the GitHub repository.

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

ibrahimiq_qcmd-1.0.2.tar.gz (44.8 kB view details)

Uploaded Source

Built Distribution

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

ibrahimiq_qcmd-1.0.2-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

Details for the file ibrahimiq_qcmd-1.0.2.tar.gz.

File metadata

  • Download URL: ibrahimiq_qcmd-1.0.2.tar.gz
  • Upload date:
  • Size: 44.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for ibrahimiq_qcmd-1.0.2.tar.gz
Algorithm Hash digest
SHA256 aea2ca09953f521fe1155af342015183fefa035fcdf8d6b65f5fb2d3c87b67ad
MD5 b91ec7256f3ab29eaba8fbe77fd29d9f
BLAKE2b-256 14422b3df181de866dae706f04edb7799bfc3df17fd54427b0aaefaf6bbec855

See more details on using hashes here.

File details

Details for the file ibrahimiq_qcmd-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: ibrahimiq_qcmd-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 22.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for ibrahimiq_qcmd-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 40a9c79094451307e93af39139a61f034deca8b09c51d41a54bc51ac698cbd64
MD5 d73ebe7db35e65491785ee7a2c40030b
BLAKE2b-256 041a68da05cc3e85404a569a28ad0ca83ecd818e1fd01b94f2e04cf55977289b

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