ChatGPT in your terminal, no OpenAI API key required
Project description
Sengpt
ChatGPT in your terminal, runs on re-gpt so no OpenAI API key required
Installation • Configuration • Usage • Building from source • Support
Installation
Ensure you have Python 3.11 and Glow installed.
pip install sengpt
Configuration
Session token
- Go to https://chat.openai.com and log in or sign up.
- Open the browser developer tools (right click and click "inspect" or "inspect element").
- Go to the Application tab (try expanding the dev tools window if you can't find it) and expand the Cookies section.
- Look for https://chat.openai.com.
- Copy the value for __Secure-next-auth.session-token.
- Run
sengpt --session_token <your-session-token-goes-here>
.
Preconfigured prompts
- Open the config file, run
sengpt --config_file
to see its location. - Add a field named
preconfigured_prompts
and set its value to key value pairs of prompt name and value e.g.,
{
"preconfigured_prompts": {
"readme": "generate a README.md for this project",
"expain": "briefly explain what this code does",
"refactor": "refactor this code to improve readability"
}
}
- To pass the prompt run
sengpt --prompt_name
orsengpt -pn
. - Warning!!! Make sure the short version of the prompt name doesn't clash with each other or with any of sengpt's default flags, i.e., a prompt name like
script_tags
will clash withsession_token
so every time you try and use it sengpt will think you want to set your session token. - The preconfigured prompts are appended to the final prompt i.e.,
some_project.py | sengpt --readme make it as brief as possible
Modes
Interactive mode
Back and forth interaction with ChatGPT, saves the conversation on exit.
Currently doesn't support piped inputs i.e., cat README.md | sengpt summarise this document
, if piped inputs are passed Query mode will be used instead.
Press Ctrl + C
to exit.
Query mode
Print ChatGPT's response, delete the conversation and exit.
Default mode
The default mode is interactive mode but you can change this in the config
{
"default_mode": "query"
}
With this configuration to use interactive mode run sengpt --interactive
Models
Either gpt-3.5
or gpt-4
can be used, the default is gpt-3.5
. gpt-4
requires a ChatGPT Plus account and is slower. To switch to gpt-4
add this in your config file.
{
"model": "gpt-4"
}
Username
How your username appears in the conversation, the default is You
.
{
"username": "Sen"
}
Usage
Usage: sengpt [prompt] [options]
-h, --help Show help message and exit
-v, --version Show the version information
-cf, --config_file Show the config file's contents and location
-st, --session_token Set session token
-ng, --no_glow Disable pretty printing with Glow,
this can be set to be the default behaviour in the config file
-c, --copy Copy the prompt response to the clipboard,
this can be set to be the default behaviour in the config file
-p, --paste Append the most recently copied clipboard text to the sent prompt
-rc, --recent_conversation Use the most recently saved conversation as context
-pp, --preconfigured_prompt Append a preconfigured prompt to the sent prompt,
replace "preconfigured_prompt" with the prompt's name
as it appears in the config file
-q, query Use query mode i.e., print ChatGPT's response and exit,
this flag is only necessary if "default_mode" in config file is interactive
-s, --save By default conversations in query mode are deleted on exit,
this saves the conversation instead,
this can be set to be the default behaviour in the config file
-i, --interactive Use interactive mode i.e., back and forth interaction with ChatGPT,
this flag is only necessary if "default_mode" in the config file is query
-d, --delete By default conversations in interactive mode are saved on exit,
this deletes then exits the interactive mode session,
this can be set to be the default behaviour in the config file
Building from Source
Ensure you have Python 3.11 and Git installed.
- Set everything up.
git clone https://github.com/SenZmaKi/Sengpt && cd Sengpt && pip install poetry && poetry install
- Run Sengpt.
poetry run sengpt
- Build the package to install with pip.
poetry build
- The
tar
andwheel
will be built atSengpt/dist
Support
- You can support the development of Sengpt through donations on GitHub Sponsors
- You can also star the github repository for other terminal enthusiasts and freedom fighters to know about it
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.