# BrowserLite 🚀
BrowserLite is a lightweight Python library for browser automation, specifically designed to interact with popular search services and AI chat interfaces like Google Search, ChatGPT, and HuggingChat. It provides a simple, intuitive API for automated browsing and text extraction.
## 🌟 Features
- Simple, intuitive API for browser automation
- Support for multiple browsers (Chrome, Edge, Firefox)
- Built-in integration with popular services:
- Google Search
- ChatGPT
- HuggingChat
- Automated text extraction and processing
- Configurable delays and safety settings
- Cross-platform compatibility
## 🔧 Installation
```bash
pip install browserlite
```
## 🚀 Quick Start
### Basic Usage
```python
from browserlite import browse, chatgpt, huggingchat
# Basic Google search
result = browse("Python programming best practices")
# ChatGPT interaction
response = chatgpt("Explain quantum computing in simple terms")
# HuggingChat interaction
response = huggingchat("Write a short story about AI")
```
### Advanced Usage
```python
from browserlite import browse
# Specify browser and search service
result = browse(
query="machine learning tutorials",
service_name="google",
browser="google-chrome",
base_url="https://www.google.com"
)
# Use ChatGPT with custom browser
response = browse(
query="Write a poem about technology",
service_name="chatgpt",
browser="firefox"
)
```
## 🎯 Why BrowserLite?
1. **Simplicity First**: Get started with just one line of code
2. **Flexibility**: Choose your preferred browser and search service
3. **AI Integration**: Built-in support for popular AI chat services
4. **Automation**: Automate repetitive browsing tasks efficiently
5. **Cross-Platform**: Works on Windows, macOS, and Linux
## 📝 Configuration
You can customize the automation behavior using the `AutomationConfig` class:
```python
from browserlite.config import AutomationConfig, BaseDelay
# Custom delay settings
custom_delays = BaseDelay(
safety_delay=2,
edge_open_delay=2,
chrome_open_delay=3,
firefox_open_delay=3,
search_delay=1.5,
max_search_time=50,
chatgpt_text_process_time=2
)
config = AutomationConfig(delays=custom_delays)
```
## 🔍 Supported Services
| Service | Description | Example |
|---------|-------------|---------|
| Google | Standard web search | `browse("query", service_name="google")` |
| ChatGPT | OpenAI's ChatGPT | `chatgpt("query")` |
| HuggingChat | Hugging Face's chat | `huggingchat("query")` |
## 🌐 Supported Browsers
- Google Chrome (`google-chrome`)
- Microsoft Edge (`microsoft-edge-stable`)
- Firefox (`firefox`)
## 📚 Examples
### 1. Web Search Automation
```python
from browserlite import browse
# Simple Google search
result = browse("latest tech news")
# Custom search with specific browser
tech_news = browse(
query="AI developments 2024",
service_name="google",
browser="google-chrome"
)
```
### 2. AI Chat Interactions
```python
from browserlite import chatgpt, huggingchat
# ChatGPT conversation
code_review = chatgpt("Review this Python code: def hello(): print('world')")
# HuggingChat interaction with custom URL
story = huggingchat(
"Write a creative story about a robot",
base_url="https://huggingface.co/chat/"
)
```
## ⚠️ Important Notes
1. Make sure you have the desired browser installed on your system
2. Some services might require authentication
3. Respect the terms of service of the platforms you're automating
4. Consider rate limits and usage policies of the services
## 🤝 Contributing
Contributions are welcome! Feel free to:
1. Fork the repository
2. Create a feature branch
3. Submit a pull request
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 🆘 Help and Support
- Report issues on GitHub
- Check the documentation
- Join our community discussions
## 🙏 Acknowledgments
- PyAutoGUI for automation capabilities
- Python community for inspiration
- All contributors and users
---
Made with ❤️
Raw data
{
"_id": null,
"home_page": "https://github.com/santhosh/",
"name": "browserlite",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Kammari Santhosh",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/45/ca/c7e980642a85990d1bbfcbb863d869ac7bcf0dfb2f696433d61bcc53d5e0/browserlite-0.0.30.tar.gz",
"platform": null,
"description": "# BrowserLite \ud83d\ude80\n\nBrowserLite is a lightweight Python library for browser automation, specifically designed to interact with popular search services and AI chat interfaces like Google Search, ChatGPT, and HuggingChat. It provides a simple, intuitive API for automated browsing and text extraction.\n\n## \ud83c\udf1f Features\n\n- Simple, intuitive API for browser automation\n- Support for multiple browsers (Chrome, Edge, Firefox)\n- Built-in integration with popular services:\n - Google Search\n - ChatGPT\n - HuggingChat\n- Automated text extraction and processing\n- Configurable delays and safety settings\n- Cross-platform compatibility\n\n## \ud83d\udd27 Installation\n\n```bash\npip install browserlite\n```\n\n## \ud83d\ude80 Quick Start\n\n### Basic Usage\n\n```python\nfrom browserlite import browse, chatgpt, huggingchat\n\n# Basic Google search\nresult = browse(\"Python programming best practices\")\n\n# ChatGPT interaction\nresponse = chatgpt(\"Explain quantum computing in simple terms\")\n\n# HuggingChat interaction\nresponse = huggingchat(\"Write a short story about AI\")\n```\n\n### Advanced Usage\n\n```python\nfrom browserlite import browse\n\n# Specify browser and search service\nresult = browse(\n query=\"machine learning tutorials\",\n service_name=\"google\",\n browser=\"google-chrome\",\n base_url=\"https://www.google.com\"\n)\n\n# Use ChatGPT with custom browser\nresponse = browse(\n query=\"Write a poem about technology\",\n service_name=\"chatgpt\",\n browser=\"firefox\"\n)\n```\n\n## \ud83c\udfaf Why BrowserLite?\n\n1. **Simplicity First**: Get started with just one line of code\n2. **Flexibility**: Choose your preferred browser and search service\n3. **AI Integration**: Built-in support for popular AI chat services\n4. **Automation**: Automate repetitive browsing tasks efficiently\n5. **Cross-Platform**: Works on Windows, macOS, and Linux\n\n## \ud83d\udcdd Configuration\n\nYou can customize the automation behavior using the `AutomationConfig` class:\n\n```python\nfrom browserlite.config import AutomationConfig, BaseDelay\n\n# Custom delay settings\ncustom_delays = BaseDelay(\n safety_delay=2,\n edge_open_delay=2,\n chrome_open_delay=3,\n firefox_open_delay=3,\n search_delay=1.5,\n max_search_time=50,\n chatgpt_text_process_time=2\n)\n\nconfig = AutomationConfig(delays=custom_delays)\n```\n\n## \ud83d\udd0d Supported Services\n\n| Service | Description | Example |\n|---------|-------------|---------|\n| Google | Standard web search | `browse(\"query\", service_name=\"google\")` |\n| ChatGPT | OpenAI's ChatGPT | `chatgpt(\"query\")` |\n| HuggingChat | Hugging Face's chat | `huggingchat(\"query\")` |\n\n## \ud83c\udf10 Supported Browsers\n\n- Google Chrome (`google-chrome`)\n- Microsoft Edge (`microsoft-edge-stable`)\n- Firefox (`firefox`)\n\n## \ud83d\udcda Examples\n\n### 1. Web Search Automation\n\n```python\nfrom browserlite import browse\n\n# Simple Google search\nresult = browse(\"latest tech news\")\n\n# Custom search with specific browser\ntech_news = browse(\n query=\"AI developments 2024\",\n service_name=\"google\",\n browser=\"google-chrome\"\n)\n```\n\n### 2. AI Chat Interactions\n\n```python\nfrom browserlite import chatgpt, huggingchat\n\n# ChatGPT conversation\ncode_review = chatgpt(\"Review this Python code: def hello(): print('world')\")\n\n# HuggingChat interaction with custom URL\nstory = huggingchat(\n \"Write a creative story about a robot\",\n base_url=\"https://huggingface.co/chat/\"\n)\n```\n\n## \u26a0\ufe0f Important Notes\n\n1. Make sure you have the desired browser installed on your system\n2. Some services might require authentication\n3. Respect the terms of service of the platforms you're automating\n4. Consider rate limits and usage policies of the services\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Feel free to:\n\n1. Fork the repository\n2. Create a feature branch\n3. Submit a pull request\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## \ud83c\udd98 Help and Support\n\n- Report issues on GitHub\n- Check the documentation\n- Join our community discussions\n\n## \ud83d\ude4f Acknowledgments\n\n- PyAutoGUI for automation capabilities\n- Python community for inspiration\n- All contributors and users\n\n---\n\nMade with \u2764\ufe0f",
"bugtrack_url": null,
"license": "MIT",
"summary": "automated browsing",
"version": "0.0.30",
"project_urls": {
"Homepage": "https://github.com/santhosh/",
"Repository": "https://github.com/santhosh/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4b14cdca53a28fbfa4e0ce78f94a0c99d391aec1716ee67603203297103f0b32",
"md5": "c4b09848c3945151aba9edb508b81f81",
"sha256": "96ce82105ae007c46d67498dd8f8544c3540393fd3a79ab47a3ab50f8c4a75a9"
},
"downloads": -1,
"filename": "browserlite-0.0.30-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4b09848c3945151aba9edb508b81f81",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 9196,
"upload_time": "2024-12-22T03:57:27",
"upload_time_iso_8601": "2024-12-22T03:57:27.714032Z",
"url": "https://files.pythonhosted.org/packages/4b/14/cdca53a28fbfa4e0ce78f94a0c99d391aec1716ee67603203297103f0b32/browserlite-0.0.30-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "45cac7e980642a85990d1bbfcbb863d869ac7bcf0dfb2f696433d61bcc53d5e0",
"md5": "0d67e606d114af4ed4e4a53ba01f0ec5",
"sha256": "f4168bbc6c04c7817f88c9c84a9834ca4e039377a728777d8e4b22d5c3faffd4"
},
"downloads": -1,
"filename": "browserlite-0.0.30.tar.gz",
"has_sig": false,
"md5_digest": "0d67e606d114af4ed4e4a53ba01f0ec5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 13607,
"upload_time": "2024-12-22T03:57:30",
"upload_time_iso_8601": "2024-12-22T03:57:30.819791Z",
"url": "https://files.pythonhosted.org/packages/45/ca/c7e980642a85990d1bbfcbb863d869ac7bcf0dfb2f696433d61bcc53d5e0/browserlite-0.0.30.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-22 03:57:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "browserlite"
}
JSON