A look at rawandahmad698/PyChatGPT: 4.2k stars on GitHub, written primarily in Python, tracked under the AI Tools category. ⚡️ Python client for the ChatGPT API with, conversation tracking, proxy support and more.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
⭐️ Like this repo? please star & consider donating to keep it maintained
Features
Save Conversations to a file
Resume conversations even after closing the program
Proxy Support
Automatically login without involving a browser
Automatically grab Access Token
Get around the login captcha (If you try to log in subsequently, you will be prompted to solve a captcha)
Saves the access token to a file, so you don't have to log in again
Automatically refreshes the access token when it expires
Uses colorama to colorize the output, because why not?
Smart Conversation Tracking
Web Demo
Integrated into Huggingface Spaces 🤗 using Gradio. Try out the Web Demo
Chatting
Creating a token
You: Hi there, My name is Rawa
Chat GPT: Hello Rawa, nice to meet you. Is there something you would like to talk about or ask me? I'm here to help with any questions you may have.
You: great, now say my name like Heisenberg
Chat GPT: Sure, Rawa like Heisenberg. Is there anything else you would like to talk about? I'm here to help with any questions you may have.
You: Sorry I meant like the episode of Breaking Bad where Walter White says Heisenberg
Chat GPT: Ah, I see. In that case, you could try saying it like this: "My name is Rawa, like Heisenberg." This is a reference to the character Walter White from the TV show Breaking Bad, who often used the pseudonym "Heisenberg" when conducting illegal activities. The character was known for his cool and calculated demeanor, so saying your name like Heisenberg in this context would mean saying it with confidence and authority.
Install
pip install chatgptpy --upgrade
Usage
[NEW] Pass a options() object to the ChatGPT() constructor to customize the session
[NEW] You can now save your conversations to a file
from pychatgpt import Chat, Options
options = Options()
# [New] Pass Moderation. https://github.com/rawandahmad698/PyChatGPT/discussions/103
# options.pass_moderation = False
# [New] Enable, Disable logs
options.log = True
# Track conversation
options.track = True
# Use a proxy
options.proxies = 'http://localhost:8080'
# Optionally, you can pass a file path to save the conversation
# They're created if they don't exist
# options.chat_log = "chat_log.txt"
# options.id_log = "id_log.txt"
# Create a Chat object
chat = Chat(email="email", password="password", options=options)
answer = chat.ask("How are you?")
print(answer)
[NEW] Resume a conversation
from pychatgpt import Chat
# Create a Chat object
chat = Chat(email="email", password="password",
conversation_id="Parent Conversation ID",
previous_convo_id="Previous Conversation ID")
answer, parent_conversation_id, conversation_id = chat.ask("How are you?")
print(answer)
# Or change the conversation id later
answer, _, _ = chat.ask("How are you?",
previous_convo_id="Parent Conversation ID",
conversation_id="Previous Conversation ID")
print(answer)
Start a CLI Session
from pychatgpt import Chat
chat = Chat(email="email", password="password")
chat.cli_chat()
Ask a one time question
from pychatgpt import Chat
# Initializing the chat class will automatically log you in, check access_tokens
chat = Chat(email="email", password="password")
answer, parent_conversation_id, conversation_id = chat.ask("Hello!")
You could also manually set, get the token
import time
from pychatgpt import OpenAI
# Manually set the token
OpenAI.Auth(email_address="email", password="password").save_access_token(access_token="", expiry=time.time() + 3600)
# Get the token, expiry
access_token, expiry = OpenAI.get_access_token()
# Check if the token is valid
is_expired = OpenAI.token_expired() # Returns True or False
Change Log
Update using pip install chatgptpy --upgrade
1.0.8
Fixes an issue when reading from id_log.txt
Introduces a new pass_moderation parameter to the options() class, defaults to False
Adds proxies to moderation.
If pass_moderation is True, the function is invoked in another thread, so it doesn't block the main thread.
1.0.7
Make a request to the mod endpoint first, otherwise a crippled version of the response is returned
1.0.6
New option to turn off logs.
Better Error handling.
Enhanced conversation tracking
Ask now returns a tuple of answer, previous_convo, convo_id
Better docs
1.0.5
Pull requests/minor fixes
1.0.4
Fixes for part 8 of token authentication
1.0.3
a new options() class method to set the options for the chat session
save the conversation to a file
resume the conversation even after closing the program
1.0.2
ChatGPT API switches from action=next to action=variant, frequently. This library is now using action=variant instead of action=next to get the next response from the API.
Sometimes when the server is overloaded, the API returns a 502 Bad Gateway error.
Added Error handling if the auth.json file is not found/corrupt
1.0.0
Initial Release via PyPi
Other notes
If the token creation process is failing:
Try to use a proxy (I recommend using this always)
Don't try to log in too fast. At least wait 10 minutes if you're being rate limited.
If you're still having issues, try to use a VPN. On a VPN, the script should work fine.
What's next?
I'm planning to add a few more features, such as:
A python module that can be imported and used in other projects
A way to save the conversation
Better error handling
Multi-user chatting
The whole process
I have been looking for a way to interact with the new Chat GPT API, but most of the sources here on GitHub
require you to have a Chromium instance running in the background. or by using the Web Inspector to grab Access Token manually.
No more. I have been able to reverse engineer the API and use a TLS client to mimic a real user, allowing the script to login without setting off any bot detection techniques by Auth0
Basically, the script logs in on your behalf, using a TLS client, then grabs the Access Token. It's pretty fast.
First, I'd like to tell you that "just making http" requests is not going to be enough, Auth0 is smart, each process is guarded by a
state token, which is a JWT token. This token is used to prevent CSRF attacks, and it's also used to prevent bots from logging in.
If you look at the auth.py file, there are over nine functions, each one of them is responsible for a different task, and they all
work together to create a token for you. allow-redirects played a huge role in this, as it allowed to navigate through the login process
I work at MeshMonitors.io, We make amazing tools (Check it out yo!). I decided not to spend too much time on this, but here we are.
Why did I do this?
No one has been able to do this, and I wanted to see if I could.
Does rawandahmad698/PyChatGPT have a project website?
No homepage URL was recorded for rawandahmad698/PyChatGPT in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Is rawandahmad698/PyChatGPT open source?
Yes — rawandahmad698/PyChatGPT ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/rawandahmad698/PyChatGPT.
What else is in the AI Tools space?
rawandahmad698/PyChatGPT is tracked by TopGit under the AI Tools category, alongside 3 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is rawandahmad698/PyChatGPT?
rawandahmad698/PyChatGPT (rawandahmad698/PyChatGPT) is a Python project on GitHub. From the project's own README: ⚡️ Python client for the ChatGPT API with, conversation tracking, proxy support and more.
What license does rawandahmad698/PyChatGPT use?
rawandahmad698/PyChatGPT is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about rawandahmad698/PyChatGPT?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/rawandahmad698/PyChatGPT is the definitive source.
Why is rawandahmad698/PyChatGPT categorized under AI Tools?
TopGit places rawandahmad698/PyChatGPT in the AI Tools category based on its GitHub topics and description (tagged: "chatgpt", "openai", "python"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Curious whether PyChatGPT is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about PyChatGPT.