the-bumblebee 1.0.0__tar.gz

the_bumblebee-1.0.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 socioy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

the_bumblebee-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include bumblebee *

the_bumblebee-1.0.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.2
+Name: the-bumblebee
+Version: 1.0.0
+Summary: An AI-powered Python package for natural, human-like mouse and keyboard control.
+Home-page: https://github.com/socioy/bumblebee
+Author: socioy
+Author-email: bumblebee@socioy.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: numpy>=2.2.4
+Requires-Dist: torch>=2.6.0
+Requires-Dist: scipy>=1.15.2
+Requires-Dist: pynput>=1.8.1
+Requires-Dist: PyAutoGUI>=0.9.54
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🐝 Bumblebee – Human-Like Mouse & Keyboard Controller
+
+<div align="center">
+  <img src="https://github.com/socioy/bumblebee/blob/master/data/logo.png" alt="Bumblebee Logo" width="400" style="border-radius: 10px;">
+</div>
+
+Bumblebee is an AI-powered Python package that provides **realistic, human-like control** of the mouse and keyboard. Unlike traditional automation tools, Bumblebee leverages deep learning to predict **natural movement patterns**, resulting in automated interactions that feel organic and smooth.
+
+---
+
+## ✨ Features
+
+- **AI-Powered Cursor Movement:**  
+  Employs an RNN augmented with an LSTM layer to create smooth, human-like mouse trajectories. These paths are further refined by introducing natural noise and variable speeds, resulting in movements that mimic real human behavior seamlessly.
+- **Smart Keystroke Simulation:**  
+  Emulates typing with natural delays, punctuation handling, and variability in keystroke timing.
+- **Extensive Training Data:**  
+  Trained on a dataset of over 25,000 real cursor movements for enhanced realism.
+- **Reinforcement Learning (Coming Soon):**  
+  Future updates will integrate RL to further refine cursor behavior.
+- **PyAutoGUI Integration:**  
+  Utilizes [PyAutoGUI](https://pyautogui.readthedocs.io/) and [pynput](https://pynput.readthedocs.io/) for simulating robust mouse and keyboard interactions.
+- **Built with PyTorch:**  
+  All AI models are developed using PyTorch.
+
+---
+
+## 🚀 How It Works
+
+### 🖱️ Cursor Movement
+
+Bumblebee predicts the cursor path using an RNN-LSTM model trained on extensive real-world cursor data. This approach avoids the robotic jumps seen in conventional automation tools, ensuring smooth and natural motion.
+
+Currently, Bumblebee's mouse moves on almost the same path if the same initial and destination positions are provided, with some noise.
+
+> **Coming Soon:**  An enhanced model incorporating Reinforcement Learning (RL) that will generate different form of paths even if same initial and destination is provided.
+
+### ⌨️ Keyboard Control
+
+The keyboard simulation is driven by:
+- **Mathematical Models:**  
+  Considering distances between keys and natural typing rhythms.
+- **Timing Variations:**  
+  Simulated delays for each keystroke to mimic human typing quirks.
+- **Punctuation & Special Characters Handling:**  
+  Adjusted behaviors to reflect realistic typing patterns.
+
+### 🏗️ Under the Hood
+
+- **Simulation:**  
+  Uses [PyAutoGUI](https://pyautogui.readthedocs.io/) for executing mouse events and [pynput] (https://pynput.readthedocs.io/) for executing keyboard events.
+- **Deep Learning:**  
+  Powered by PyTorch models trained on self-collected datasets of human interactions for predicting intermediate points between starting position and destination.
+
+---
+
+## ⚙️ How to Use
+
+1. Install Bumblebee
+
+```bash
+pip install bumblebee
+```
+2. Import the core modules and use them as following:
+
+#### Mouse Control Examples
+
+```python
+from bumblebee import Mouse
+
+# Initialize controllers
+mouse = Mouse()
+
+
+# Set mouse speed (pixels per second)
+mouse.set_speed(1000)
+
+# Move mouse to specific coordinates
+mouse.move(100, 200)
+
+# Drag mouse from the current position to a new location
+mouse.drag_to(233, 244)
+
+# Simulate a mouse click (button options: "left", "middle", "right", "primary", "secondary")
+mouse.click(button="left")
+
+# Move to a position then click
+mouse.move_to_and_click(destX=150, destY=250, button="left")
+```
+
+#### Keyboard Control Example
+
+Initialize the Keyboard controller and adjust its typing behavior:
+
+```python
+from bumblebee import Keyboard
+
+# Initialize the Keyboard controller with default parameters:
+#   - typing_speed: 100 (default percentage of ideal speed)
+#   - consistency: 95 (default consistency percentage, affecting delay variability)
+#   - typo_rate: 5 (default typo frequency percentage)
+keyboard = Keyboard()
+
+# Adjust typing speed.
+# The typing speed is provided as a percentage relative to the original Bumblebee typing speed.
+# Acceptable types: int or float.
+keyboard.set_speed(new_speed=400)  # Increase the typing speed to 400%
+
+# Adjust typo rate.
+# The new typo rate must be a value between 0 and 100 (int or float).
+keyboard.set_typo_rate(3)  # Set typo rate to 3%
+
+# Adjust consistency.
+# A higher consistency (0-100) increases typing speed with less delay variability.
+keyboard.set_consistency(99)  # Set consistency to 99%
+
+# Type a sample text.
+text = "Bumblebee is great."
+keyboard.type(text)  # 'text' must be a string.
+```
+
+---
+
+### Interested in contributing? 
+Please take a moment to review our [CONTRIBUTING.md](https://github.com/socioy/bumblebee/blob/master/CONTRIBUTING.md) file for detailed guidelines on how to join our community and help shape Bumblebee’s future.
+
+🐝 **Making automation feel more human, one movement at a time.**

the_bumblebee-1.0.0/README.md

@@ -0,0 +1,127 @@
+# 🐝 Bumblebee – Human-Like Mouse & Keyboard Controller
+
+<div align="center">
+  <img src="https://github.com/socioy/bumblebee/blob/master/data/logo.png" alt="Bumblebee Logo" width="400" style="border-radius: 10px;">
+</div>
+
+Bumblebee is an AI-powered Python package that provides **realistic, human-like control** of the mouse and keyboard. Unlike traditional automation tools, Bumblebee leverages deep learning to predict **natural movement patterns**, resulting in automated interactions that feel organic and smooth.
+
+---
+
+## ✨ Features
+
+- **AI-Powered Cursor Movement:**  
+  Employs an RNN augmented with an LSTM layer to create smooth, human-like mouse trajectories. These paths are further refined by introducing natural noise and variable speeds, resulting in movements that mimic real human behavior seamlessly.
+- **Smart Keystroke Simulation:**  
+  Emulates typing with natural delays, punctuation handling, and variability in keystroke timing.
+- **Extensive Training Data:**  
+  Trained on a dataset of over 25,000 real cursor movements for enhanced realism.
+- **Reinforcement Learning (Coming Soon):**  
+  Future updates will integrate RL to further refine cursor behavior.
+- **PyAutoGUI Integration:**  
+  Utilizes [PyAutoGUI](https://pyautogui.readthedocs.io/) and [pynput](https://pynput.readthedocs.io/) for simulating robust mouse and keyboard interactions.
+- **Built with PyTorch:**  
+  All AI models are developed using PyTorch.
+
+---
+
+## 🚀 How It Works
+
+### 🖱️ Cursor Movement
+
+Bumblebee predicts the cursor path using an RNN-LSTM model trained on extensive real-world cursor data. This approach avoids the robotic jumps seen in conventional automation tools, ensuring smooth and natural motion.
+
+Currently, Bumblebee's mouse moves on almost the same path if the same initial and destination positions are provided, with some noise.
+
+> **Coming Soon:**  An enhanced model incorporating Reinforcement Learning (RL) that will generate different form of paths even if same initial and destination is provided.
+
+### ⌨️ Keyboard Control
+
+The keyboard simulation is driven by:
+- **Mathematical Models:**  
+  Considering distances between keys and natural typing rhythms.
+- **Timing Variations:**  
+  Simulated delays for each keystroke to mimic human typing quirks.
+- **Punctuation & Special Characters Handling:**  
+  Adjusted behaviors to reflect realistic typing patterns.
+
+### 🏗️ Under the Hood
+
+- **Simulation:**  
+  Uses [PyAutoGUI](https://pyautogui.readthedocs.io/) for executing mouse events and [pynput] (https://pynput.readthedocs.io/) for executing keyboard events.
+- **Deep Learning:**  
+  Powered by PyTorch models trained on self-collected datasets of human interactions for predicting intermediate points between starting position and destination.
+
+---
+
+## ⚙️ How to Use
+
+1. Install Bumblebee
+
+```bash
+pip install bumblebee
+```
+2. Import the core modules and use them as following:
+
+#### Mouse Control Examples
+
+```python
+from bumblebee import Mouse
+
+# Initialize controllers
+mouse = Mouse()
+
+
+# Set mouse speed (pixels per second)
+mouse.set_speed(1000)
+
+# Move mouse to specific coordinates
+mouse.move(100, 200)
+
+# Drag mouse from the current position to a new location
+mouse.drag_to(233, 244)
+
+# Simulate a mouse click (button options: "left", "middle", "right", "primary", "secondary")
+mouse.click(button="left")
+
+# Move to a position then click
+mouse.move_to_and_click(destX=150, destY=250, button="left")
+```
+
+#### Keyboard Control Example
+
+Initialize the Keyboard controller and adjust its typing behavior:
+
+```python
+from bumblebee import Keyboard
+
+# Initialize the Keyboard controller with default parameters:
+#   - typing_speed: 100 (default percentage of ideal speed)
+#   - consistency: 95 (default consistency percentage, affecting delay variability)
+#   - typo_rate: 5 (default typo frequency percentage)
+keyboard = Keyboard()
+
+# Adjust typing speed.
+# The typing speed is provided as a percentage relative to the original Bumblebee typing speed.
+# Acceptable types: int or float.
+keyboard.set_speed(new_speed=400)  # Increase the typing speed to 400%
+
+# Adjust typo rate.
+# The new typo rate must be a value between 0 and 100 (int or float).
+keyboard.set_typo_rate(3)  # Set typo rate to 3%
+
+# Adjust consistency.
+# A higher consistency (0-100) increases typing speed with less delay variability.
+keyboard.set_consistency(99)  # Set consistency to 99%
+
+# Type a sample text.
+text = "Bumblebee is great."
+keyboard.type(text)  # 'text' must be a string.
+```
+
+---
+
+### Interested in contributing? 
+Please take a moment to review our [CONTRIBUTING.md](https://github.com/socioy/bumblebee/blob/master/CONTRIBUTING.md) file for detailed guidelines on how to join our community and help shape Bumblebee’s future.
+
+🐝 **Making automation feel more human, one movement at a time.**

the_bumblebee-1.0.0/bumblebee/__init__.py

@@ -0,0 +1,2 @@
+from .keyboard import *
+from .mouse import *

the_bumblebee-1.0.0/bumblebee/ai/__init__.py

@@ -0,0 +1,2 @@
+from .predict import Predictor
+from .rnn import CursorRNN

the_bumblebee-1.0.0/bumblebee/ai/models/README.md

@@ -0,0 +1,3 @@
+## Production-Ready Models
+
+This directory contains pre-trained models, fully optimized and ready for production use.