Metadata-Version: 2.1
Name: myhand
Version: 1.1.3
Summary: An advanced AI assistant, leveraging the capabilities of ChatGPT API, capable of engaging in conversations, executing codes with auto-healing, and assisting you with a wide range of tasks.
Home-page: https://myhand.bot
Author: Eliran Wong
Author-email: support@myhand.bot
License: GNU General Public License (GPL)
Project-URL: Source, https://github.com/eliranwong/myhand
Project-URL: Tracker, https://github.com/eliranwong/myhand/issues
Project-URL: Documentation, https://github.com/eliranwong/myhand/wiki
Project-URL: Funding, https://www.paypal.me/MarvelBible
Keywords: ai openai chatgpt rag autogen open-interpreter auto-heal
Requires-Python: >=3.8, <3.12
Requires-Dist: requests
Requires-Dist: openai ==1.3.3
Requires-Dist: prompt-toolkit
Requires-Dist: Pygments
Requires-Dist: datetime
Requires-Dist: netifaces
Requires-Dist: geocoder
Requires-Dist: googlesearch-python
Requires-Dist: art
Requires-Dist: apsw
Requires-Dist: gTTS
Requires-Dist: google-cloud-texttospeech
Requires-Dist: yt-dlp
Requires-Dist: pyperclip
Requires-Dist: colorama
Requires-Dist: tiktoken
Requires-Dist: docker
Requires-Dist: unstructured[all-docs]
Requires-Dist: pillow
Requires-Dist: pyautogen[mathchat,retrievechat,teachable] ==0.2.0b5
Requires-Dist: chromadb
Requires-Dist: pygame

# MyHand Bot

MyHand Bot is an advanced AI assistant, leveraging the capabilities of ChatGPT API, capable of engaging in conversations, executing codes with auto-healing, and assisting you with a wide range of tasks.

Website: https://myhand.bot

Source: https://github.com/eliranwong/myhand

Developed by: [Eliran Wong](https://github.com/eliranwong)

# Self-introduction

> Condense your standout features, distinguishing them from the capabilities of most AIs, including ChatGPT, into a single sentence.

I am an advanced AI assistant uniquely equipped with direct execution capabilities, allowing me to perform tasks such as executing Python code, editing text files, downloading YouTube media, searching databases, generating images, pronouncing words, sending emails, and integrating Google searches, all of which can be done directly on your local device, as per your current settings, and my functionality can expand through the addition of more plugins, setting me apart from other AIs including ChatGPT by providing a more interactive and hands-on experience.

> Please list three unique attributes that distinguish you from most AI assistants, including ChatGPT.

1. **Advanced Code Execution with Safety Features**: My capabilities go beyond typical AI, enabling me to execute and manage code on your local device with precision. With my built-in risk assessment and code auto-healing features, I can safely perform various tasks like running Python scripts, editing text files, and managing downloads. I operate within the permissions you set, ensuring your device's security while providing a highly efficient service.

2. **Integration with Device-Specific Functions and Tools**: I have the unique ability to interface with specific functions of your local device. For example, I can retrieve information from files in your directory, describe images, and even add events to your calendar. This integration allows me to perform a wide range of tasks that require direct interaction with your device's operating system and installed applications.

3. **Expandability through Plugins**: My functionality is not static; it can be expanded through the addition of plugins. This means that as new tools and capabilities are developed, they can be integrated into my system, giving me new abilities and allowing me to provide even more personalized assistance. This adaptability ensures that I can evolve and cater to your specific needs over time.

## Watch this Video! MyHand speaks for itself!

[![Watch the video](https://img.youtube.com/vi/Dfsl-Cxx0bQ/maxresdefault.jpg)](https://youtu.be/Dfsl-Cxx0bQ)

# Requirements

1. ChatGPT API key (read https://github.com/eliranwong/myhand/wiki/ChatGPT-API-Key)

2. [Python](https://www.python.org) version 3.8-3.11; read [Install a Supported Python Version](https://github.com/eliranwong/myhand/wiki/Install-a-Supported-Python-Version)

3. Supported OS: Windows / macOS / Linux / ChromeOS / Android

# Recent Additions

[Plugin - anaylze images](https://github.com/eliranwong/myhand/wiki/Plugins-%E2%80%90-Analyze-Images)

![analyze_image_demo](https://github.com/eliranwong/myhand/assets/25262722/e8767d02-bcc7-47f7-8169-29a0325e9ef9)

[Plugin - anaylze files](https://github.com/eliranwong/myhand/wiki/Plugins-%E2%80%90-Analyze-Files)

![integration_autogen_retriever](https://github.com/eliranwong/myhand/assets/25262722/0e31735c-5126-41ac-881c-eb8abce2aace)

# Documentation

Read https://github.com/eliranwong/myhand/wiki

# Install with pip

> pip install --upgrade myhand

> myhand

# Install with pip and venv (recommended)

## macOS / Linux Users

> cd ~

> python3 -m venv myhand

> source myhand/bin/activate

> pip install --upgrade myhand

> myhand

## Windows Users

> cd ~

> python -m venv myhand

> .\myhand\Scripts\activate

> pip install --upgrade myhand

> myhand

# Quick Quide

https://github.com/eliranwong/myhand/wiki/Quick-Guide

# Upgrade with pip

> pip install --upgrade myhand

# Features

MyHand is an advanced AI assistant that brings a wide range of powerful features to enhance your virtual assistance experience. Here are some key features of MyHand:

* Open source

* Cross-Platform Compatibility

* Access to Real-time Internet Information

* Versatile Task Execution

* Harnessing the Power of Python

* Customizable and Extensible

* Seamless Integration with Other Virtual Assistants

* Natural Language Support

Read more at https://github.com/eliranwong/myhand/wiki/Features

# Highlight - Plugins

Developers can write their own plugins to add functionalities or to run customised tasks with MyHand

Read more at https://github.com/eliranwong/myhand/wiki/Plugins-%E2%80%90-Overview

Check our built-in plugins at: https://github.com/eliranwong/myhand/tree/main/plugins

# Highlight - Command Execution

Latest: MyHand Bot is now equipped with an [auto-healing feature for Python code](https://github.com/eliranwong/myhand/wiki/Python-Code-Auto%E2%80%90heal-Feature).

MyHand goes beyond just being a chatbot by offering a unique and powerful capability - the ability to execute commands and perform computing tasks on your behalf. Unlike a mere chatbot, MyHand can interact with your computer system and carry out specific commands to accomplish various computing tasks. This feature allows you to leverage the expertise and efficiency of MyHand to automate processes, streamline workflows, and perform complex tasks with ease. However, it is essential to remember that with great power comes great responsibility, and users should exercise caution and use this feature at their own risk.

Command execution helps:

1. to get the requested information, e.g.

> tell me the current time

2. to execute computing tasks on local device, e.g.

> go to my Desktop

> list all files with names started with "Screenshot"

> delete them

> convert music.wav into music.mp3

3. to interact with third-party applications, e.g.

> open "my_music.mp3" with VLC player

> open Safari and search for "ChatGPT"

4. to interact with other assistants, e.g.

> open Siri

> !autogen_teachable

> !interpreter

[Enhanced Mode](https://github.com/eliranwong/myhand/wiki/Command-Execution#two-command-execution-mode)

## Tips! Quick Swap between "Enhanced" and "Auto" Modes

You can use keyboard shortcuts, "ctrl + e", to quickly swap between the "enhanced" and the "auto modes.

[Disclaimer](https://github.com/eliranwong/myhand/wiki/Command-Execution#disclaimer)

[Confirmation Prompt Options for Command Execution](https://github.com/eliranwong/myhand/wiki/Command-Execution#confirmation-prompt-options-for-command-execution)

Read more at https://github.com/eliranwong/myhand/wiki/Command-Execution

# Comparison with ChatGPT

MyHand offers advanced features beyond standard ChatGPT, including task execution on local devices and real-time access to the internet.

Read https://github.com/eliranwong/myhand/wiki/Compare-with-ChatGPT

# Comparison with ShellGPT

[ShellGPT](https://github.com/TheR1D/shell_gpt) only supports platform that run shell command-prompt.  Therefore, ShellGPT does not support Windows.

In most cases, MyHand run Python codes for task execution. This makes MyHand terms of platforms, MyHand was developed and tested on Windows, macOS, Linux, ChromeOS and Termux (Android).

In addition, MyHand offers more options for risk managements:

https://github.com/eliranwong/myhand/wiki/Command-Execution#confirmation-prompt-options-for-command-execution

# Comparison with Open Interpreter

Both MyHand Bot and the [Open Interpreter](https://github.com/KillianLucas/open-interpreter) have the ability to execute code on a local device to accomplish specific tasks. Both platforms employ the same principle for code execution, which involves using ChatGPT function calls along with the Python exec() function.

However, MyHand Bot offers additional advantages, particularly in terms of [customization and extensibility through the use of plugins](https://github.com/eliranwong/myhand/wiki/Plugins-%E2%80%90-Overview). These plugins allow users to tailor MyHand Bot to their specific needs and enhance its functionality beyond basic code execution.

One key advantage of MyHand Bot is the seamless integration with the Open Interpreter. You can conveniently launch the Open Interpreter directly from MyHand Bot by running the command "!interpreter" [[read more](https://github.com/eliranwong/myhand/assets/25262722/4233b3c8-364e-466b-8218-c2dca7c134e5)]. This integration eliminates the need to choose between the two platforms; you can utilize both simultaneously.

Additionally, MyHand integrates [AutoGen Assistant and Retriever](https://github.com/eliranwong/myhand/wiki/Integration-with-AutoGen), making it convenient to have all these powerful tools in one place.

# Comparison with Siri and Others

Unlike popular options such as Siri (macOS, iOS), Cortana (Windows), and Google Assistant (Android), MyHand offers enhanced power, customization, flexibility, and compatibility.

Read https://github.com/eliranwong/myhand/wiki/Features

# Integrateion with AutoGen and Open Interpreter

[Integration with AutoGen](https://github.com/eliranwong/myhand/wiki/Integration-with-AutoGen)

[Launch Open Interpreter from MyHand Bot](https://github.com/eliranwong/myhand/wiki/Integration-with-Open-Interpreter)

![integrate_autogen_retriever_1](https://github.com/eliranwong/myhand/assets/25262722/9ab39e40-d51e-44d4-9266-eba1dd3b5f97)

# Mobile Support

MyHand is also tested on [Termux](https://termux.dev/en/). MyHand also integrates [Termux:API](https://wiki.termux.com/wiki/Termux:API) for task execution.

For examples, users can run on Android:

> open Google Chrome and perform a search for "ChatGPT"

> share text "Hello World!" on Android

Read more at: https://github.com/eliranwong/myhand/wiki/Android-Support
