Skip to main content

TGPT is a CLI interface to OpenAI's GPT models, bringing GPT to the Linux terminal and console

Project description


TGPT is a command-line tool for interacting with OpenAI's GPT-3.5-turbo model and generating images using DALL-E. This tool allows users to generate text completions and create images or variations of existing images using text prompts.

Table of Contents


  1. Install the package using pip:
pip install tgpt


Text Completions

To generate text completions, you can run TGPT with your text prompt as an argument:

tgpt "Your text prompt here"

Image Generation

To generate an image based on a text prompt, use the gi command followed by the text prompt:

tgpt gi "A futuristic city skyline"

Image Variation

To generate a variation of an existing image, use the gv command followed by the path to the image:

tgpt gv "/path/to/your/image.png"

Classes Overview


Handles the retrieval of the API key, model, image path, max tokens, and temperature from the configuration file.


Provides a command-line interface for interacting with the GPTClient and ImageHandler classes. It allows users to generate text completions, images, and image variations.


Responsible for making requests to OpenAI's API. It handles text completions and communicates with the ImageHandler for image-related tasks.


Manages image generation and variation requests to the DALL-E API. It provides functions to generate images based on text prompts and create variations of existing images.

Additional Features and Options

Chat Mode

To enter chat mode, use the --chat flag:

tgpt --chat

In chat mode, you can have a conversation with the AI by typing your messages in the terminal. Type /exit or /quit to end the session, /help for more commands.

Customizing Text Completions

You can customize the text completions by setting the -t, -n, and -m options:

tgpt tx "Your text prompt here" -t 0.5 -n 3 -m 50

-t or --temp: Controls the randomness of the AI's output (default: 0.7). -n or --num: The number of completions to generate (default: 1). -m or --max: The maximum number of tokens to generate for completions (default: 100).

Customizing Image Generation and Variation

You can customize the image generation and variation by setting the -s and -n options:

tgpt gi "A futuristic city skyline" -s large -n 3

-s or --size: The size of the generated images (options: small, medium, large; default: medium). -n or --num: The number of images to generate or vary (default: 1).


Magnus Jansson:


Contributions are welcome! Please submit a pull request or create an issue to propose changes or report bugs.


GNU General Public License v3.0


New Features and Improvements
- Restructured the project into a Python package for easy installation and distribution.
- Added the ConfigHandler class for managing configuration, including API key, model, image path, max tokens, and temperature.
- Replaced the old API key retrieval method with the ConfigHandler class.
- Deprecated the script and the tgpt script. Users should use pip to install the package.
- Enhanced the command-line interface with new options and arguments for greater flexibility and control.
Removals and Deprecations
- Removed the script as it is now replaced by the package installation using pip.
- Removed the script and the tgpt file, as the package structure replaces the need for combining files.
- Deprecated the manual installation instructions for the tgpt script. Users should use pip to install the package.
- Removed the old image save path configuration method. The image save path is now part of the configuration managed by ConfigHandler.

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

tgpt-0.1.0.tar.gz (24.0 kB view hashes)

Uploaded source

Built Distribution

tgpt-0.1.0-py3-none-any.whl (24.6 kB view hashes)

Uploaded py3

Supported by

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