Metadata-Version: 2.4
Name: gtalk
Version: 2.0.0
Summary: Interactive terminal interface for Google AI Mode - get AI-powered answers, code examples, and explanations directly in your command line
Home-page: https://github.com/hissain/gtalk
Author: Md. Sazzad Hissain Khan
Author-email: "Md. Sazzad Hissain Khan" <hissain.khan@gmail.com>
Maintainer: Md. Sazzad Hissain Khan
Maintainer-email: hissain.khan@gmail.com
License: MIT
Project-URL: Homepage, https://github.com/hissain/gtalk
Project-URL: Documentation, https://github.com/hissain/gtalk#readme
Project-URL: Repository, https://github.com/hissain/gtalk
Project-URL: Bug Tracker, https://github.com/hissain/gtalk/issues
Project-URL: Changelog, https://github.com/hissain/gtalk/releases
Keywords: google,ai,aimode,cli,terminal,search,assistant,chatbot,artificial-intelligence,command-line,interactive,code-examples,query,open-source
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Environment :: Console
Classifier: Natural Language :: English
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: selenium>=4.15.0
Requires-Dist: beautifulsoup4>=4.12.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: requires-python

# 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 context aware answers, code examples, and explanations without leaving your command line!

## Features

- **Interactive Mode** - Keep querying without restarting
- **Context Aware** - Context aware subsequent query in interactive mode
- **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)

```bash
pip install gtalk
```

### From Source (Latest Features + Bugfixes)

```bash
git clone https://github.com/hissain/gtalk.git
cd gtalk
pip install -e .
```

## Quick Start

### Interactive Mode

Simply run:

```bash
gtalk
```

Then start asking questions:

```
Query> Who is Elon Musk?
Query> How many children he has?
Query> Write a python code for printing first 10 Fibonacci numbers?
Query> quit
```

### Demo Terminal

![Demo Terminal](res/Screenshot-Interactive-Mode.png)

### Single Query Mode

```bash
gtalk "What is machine learning?"
```

## Command Line Arguments

| Argument              | Description                                  |
| --------------------- | -------------------------------------------- |
| `-v`, `--verbose` | Enable verbose output for debugging purposes |
| `-s`, `--short`   | Use short query mode                         |

## Usage Examples

### Getting Code Examples

```bash
Query> Write a Python function for bubble sort
```

Output includes both explanation and code:

```python
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

```bash
Query> Explain binary trees
Query> What is the difference between TCP and UDP?
Query> How does async/await work in JavaScript?
```

### Quick References

```bash
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

### 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](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](https://www.selenium.dev/)
- Parsing powered by [Beautiful Soup](https://www.crummy.com/software/BeautifulSoup/)
- Inspired by the need for quick terminal-based AI assistance

## Contact & Support

- **Author**: Md. Sazzad Hissain Khan
- **Email**: hissain.khan@gmail.com
- **GitHub**: [@hissain](https://github.com/hissain)
- **Issues**: [GitHub Issues](https://github.com/hissain/gtalk/issues)

---

Made with love by [Md. Sazzad Hissain Khan](https://github.com/hissain)
