A command-line interface to interact with Google's AI Mode
Project description
GTalk - Google AI Mode Terminal Query Tool
A powerful command-line interface to interact with Google's AI Mode directly from your terminal. Get AI-powered answers, code examples, and explanations without leaving your command line!
✨ Features
- 🚀 Interactive Mode - Keep querying without restarting
- 💻 Code Block Support - Properly formatted code examples
- ⚡ Fast - Browser session reused across queries
- 🎯 Clean Output - Well-formatted, readable responses
- 🔄 Both Modes - Interactive or single-query mode
📦 Installation
From PyPI (Recommended)
pip install gtalk
From Source
git clone https://github.com/hissain/gtalk.git
cd gtalk
pip install -e .
Additional Requirements
You'll also need ChromeDriver installed:
macOS:
brew install chromedriver
# If you get a security warning:
xattr -d com.apple.quarantine $(which chromedriver)
Linux:
# Ubuntu/Debian
sudo apt-get install chromium-chromedriver
# Fedora
sudo dnf install chromedriver
Windows: Download from ChromeDriver Downloads and add to PATH
🚀 Quick Start
Interactive Mode
Simply run:
gtalk
Then start asking questions:
Query> What is Python?
Query> Write a binary search function
Query> How do I reverse a string in JavaScript?
Query> quit
Single Query Mode
gtalk "What is machine learning?"
📖 Usage Examples
Getting Code Examples
Query> Write a Python function for bubble sort
Output includes both explanation and code:
def bubble_sort(arr):
n = len(arr)
for i in range(n):
for j in range(0, n-i-1):
if arr[j] > arr[j+1]:
arr[j], arr[j+1] = arr[j+1], arr[j]
return arr
Learning Concepts
Query> Explain binary trees
Query> What is the difference between TCP and UDP?
Query> How does async/await work in JavaScript?
Quick References
Query> Git command to undo last commit
Query> Python list comprehension syntax
Query> Docker commands cheat sheet
🎮 Interactive Commands
Once in interactive mode:
| Command | Description |
|---|---|
[any text] |
Query Google AI Mode |
help |
Show available commands |
clear |
Clear the screen |
quit, exit, q |
Exit the program |
Ctrl+C |
Force exit |
Ctrl+D |
Alternative exit |
⚙️ Configuration
GTalk uses headless Chrome by default. The browser session is reused across queries for better performance.
🐛 Troubleshooting
CAPTCHA Detected
If you see "Google has detected automated access":
- Wait a few minutes between queries
- Use a VPN or different network
- Reduce query frequency
ChromeDriver Not Found
Make sure ChromeDriver is installed and in your PATH:
# Check if chromedriver is available
which chromedriver
# macOS: Install via Homebrew
brew install chromedriver
No Summary Found
If no AI summary is returned:
- Try rephrasing your query
- Use question format: "What is...", "How to...", "Explain..."
- Some queries may not trigger AI Mode
🔒 Privacy & Rate Limiting
- GTalk makes direct requests to Google
- No data is stored or logged by this tool
- Respect Google's rate limits - avoid excessive automated queries
- Consider delays between queries if using programmatically
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
⚠️ Disclaimer
This tool is for educational and personal use only. It interacts with Google Search's public interface. Please use responsibly and in accordance with Google's Terms of Service.
🙏 Acknowledgments
- Built with Selenium
- Parsing powered by Beautiful Soup
- Inspired by the need for quick terminal-based AI assistance
📮 Contact & Support
- Author: Md. Sazzad Hissain Khan
- Email: hissain.khan@gmail.com
- GitHub: @hissain
- Issues: GitHub Issues
Made with ❤️ by Md. Sazzad Hissain Khan
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.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gtalk-0.1.0.tar.gz.
File metadata
- Download URL: gtalk-0.1.0.tar.gz
- Upload date:
- Size: 8.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a10348c4c2f5d44b874a2e2db05d250e64bf20774a3852eb2620da9c806f2df3
|
|
| MD5 |
3b079579000a000c1723d58bd66c0f61
|
|
| BLAKE2b-256 |
7d95fb017101bd10588a22e565305c4754c0aeb2097437d6346c56da6b5027de
|
File details
Details for the file gtalk-0.1.0-py3-none-any.whl.
File metadata
- Download URL: gtalk-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aea228c0276e34b4b279c1a6f9e1122b0e3b51a1f159dfd8f85ba93275e6e020
|
|
| MD5 |
65a79480660dc9733624ebfefb6b9b55
|
|
| BLAKE2b-256 |
87b2b1fa5868ffe23eea424d52e446c254226bad9b8d6191e3a94dda7b358df0
|