Skip to main content

unixgpt is a powerful bridge between natural language and UNIX commands

Project description

🗣️ unixgpt

unixgpt pypi image image release ruff

unixgpt is a powerful bridge between natural language and UNIX commands.

A valid OpenAI API Key is required to run unixgpt (you can get one here: https://openai.com/blog/openai-api)

export OPENAI_API_KEY="enter key here"

The latest version of unixgpt can be installed from PyPI:

pip install unixgpt

To upgrade to the latest version:

pip install --upgrade unixgpt

Building Locally

Docker

Build the Docker image

docker build -t unixgpt-cli .

Create and run the Docker container (with a valid OpenAI API Key)

docker run -e OPENAI_API_KEY unixgpt-cli

Note: Input can be edited in Dockerfile

pip

Build via pip (from source code)

pip install .

Run via pip

unixgpt -i "enter input here"

Features

  1. Conversion: Seamlessly transform natural language queries into their corresponding UNIX commands.

  2. Command Options: After generating a command, enjoy the following flexibility:

  • Execute: Execute the generated UNIX command directly.
  • Save: Store frequently used commands locally for swift and convenient access.
  • Copy: Copy the generated command to the clipboard, simplifying pasting and use in your terminal.
  1. Reusability: It's not just about storing commands; it's a versatile tool for saving and editing custom commands via natural language, ensuring your workflow remains flexible and efficient.

Examples

Conversion

https://github.com/jamino30/unixgpt/blob/main/assets/demo.gif

Input: unixgpt -i "I want to see any uses of the 'git commit' command in my history"

Output: history | grep "git commit"
Input: unixgpt -i "Use the Dockerfile in the cwd to create an image called project-image"

Output: docker build -t project-image .
Input: unixgpt --input "Show me the current processes running on port 8000"

Output: lsof -i :8000

Save

Input: unixgpt -s "git commit && git push"

Output: "Added to UnixGPT local library"
Input: unixgpt --save 1599

Output: "Added to UnixGPT local library"

Fetch

Input: unixgpt -f "command that commits and pushes via Git"

Output: git commit && git push
Input: unixgpt --fetch 23

Output: "Returns command in UnixGPT local library with ID:23"

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

unixgpt-0.1.6.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

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

unixgpt-0.1.6-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file unixgpt-0.1.6.tar.gz.

File metadata

  • Download URL: unixgpt-0.1.6.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for unixgpt-0.1.6.tar.gz
Algorithm Hash digest
SHA256 13c35a0266ece585d4e80e012db7919ed3b04e1f455d494ce083956cb261c8b4
MD5 c3d4a792f1fec6d4267590aa3dcce84a
BLAKE2b-256 094f074d918ed1cecd7797880a62da156aa85854d0e54baab6796a6ba975664b

See more details on using hashes here.

File details

Details for the file unixgpt-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: unixgpt-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 9.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for unixgpt-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4e095667aaaf5aa984ad2a81b6a681f2585736b6e74f120b244b37c96f27bcbf
MD5 e698c629d33d2832af5e59ffc8013ee4
BLAKE2b-256 cf009201dc1aac9e7d0157841a5d6a8e9b3b4a53393bd9beafdaf34771b6751f

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