Installation

Requirements

• Python 3.11 or newer
• A ChatGPT account you are authorized to use
• A graphical desktop for first-time sign-in
• Xvfb on Linux for invisible browser sessions
• Glow, optionally, for richer terminal Markdown

1. Clone the repository

git clone https://github.com/llegaspo/sengpt-.git Sengpt
cd Sengpt

2. Create a virtual environment

python -m venv .venv
source .venv/bin/activate

On Windows, activate the environment with .venv\Scripts\activate.

3. Install Sengpt and Chromium

pip install -e .
playwright install chromium

4. Add Xvfb on Linux

Normal invisible sessions on Linux run a full Chromium browser inside Xvfb. Install the package for your distribution:

sudo apt install xvfb

sudo pacman -S xorg-server-xvfb

5. Sign in

sengpt --login

A Chromium window opens on ChatGPT. Complete the normal sign-in flow; Sengpt closes the window after the prompt composer is ready.