Skip to main content

A command-line interface to interact with Google's AI Mode

Project description

GTalk - Google AI Mode Terminal Query Tool

PyPI version Python Support License: MIT

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.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. 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


Made with ❤️ by Md. Sazzad Hissain Khan

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

gtalk-0.1.0.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gtalk-0.1.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

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

Hashes for gtalk-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a10348c4c2f5d44b874a2e2db05d250e64bf20774a3852eb2620da9c806f2df3
MD5 3b079579000a000c1723d58bd66c0f61
BLAKE2b-256 7d95fb017101bd10588a22e565305c4754c0aeb2097437d6346c56da6b5027de

See more details on using hashes here.

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

Hashes for gtalk-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 aea228c0276e34b4b279c1a6f9e1122b0e3b51a1f159dfd8f85ba93275e6e020
MD5 65a79480660dc9733624ebfefb6b9b55
BLAKE2b-256 87b2b1fa5868ffe23eea424d52e446c254226bad9b8d6191e3a94dda7b358df0

See more details on using hashes here.

Supported by

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