# ToolMate AI
ToolMate AI, formerly known as FreeGenius AI, is a cutting-edge AI companion that seamlessly integrates agents, tools, and plugins to excel in conversations, generative work, and task execution. With the ability to perform multi-step actions, users can customize workflows to tackle complex projects with ease.
# Background
https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/LetMeDoIt%20Mode.md
# Documentation
https://github.com/eliranwong/toolmate/wiki
# Latest changes
https://github.com/eliranwong/toolmate/blob/main/latest_changes.md
# Supported Platforms
Windows, macOS, Linux, ChromeOS, Android
# AI Backends and Models
ToolMate AI supports a wide range of AI backends and models, including [Ollama, Llama.cpp, Llama-cpp-python, Groq Cloud API, Mistral AI API, X AI API, OpenAI API, Google AI Studio API and Google Vertex AI](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Supported%20Backends%20and%20Models.md). Llama-cpp-python is selected as the default backend because it is completely free and requires no additional setup. However, users can switch backends at any time.
Our recommendations:
* For backend selection, we consider [Ollama](https://ollama.com/) as the best friendly free `offline` option and [Groq Cloud API](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Groq%20API%20Setup.md) as the best freiendly and free `online` option.
* Remarks: Though Llama.cpp requires extra setup, it runs faster inference with the same model, compared to Ollama, when they are running on Android Termux.
Read more at https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Supported%20Backends%20and%20Models.md
# New Additions
[NEW! Support Ollama v0.5.0+ latest structured output feature](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Configure%20Ollama%20Server.md)
[NEW! Support Llama.cpp server running on Android](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Android%20Versions.md)
[NEW! Support X AI / Grok API Keys](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/xAI.md)
[NEW! ToolMate API Server & Client](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/ToolMate%20API%20Server.md)
[NEW! Support Mistral API Keys](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Mistral%20API%20Setup.md)
[NEW! Edit Current Conversation](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Edit%20Current%20Conversation.md)
[NEW! Support Android](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Android%20Versions.md)
[NEW! Perplexica and SearXNG Integration](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Perplexica%20and%20SearXNG%20Integration.md#searxng-setup)
# Distinctive Features
[Tool Selection Agent](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Selection%20Configurations.md)
[Deep Reflection Agents](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Reflection%20Agents.md)
[Risk Management Agent](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Risk%20Management%20Agent.md)
[Running Multiple Tools in One Go](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Running%20Multiple%20Tools%20in%20One%20Go.md)
[Plentiful Built-in Tools](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Descriptions.md)
[Highly Customisable Plugins](https://github.com/eliranwong/toolmate/wiki#plugins)
[Savable, Searchable and Sharable Records](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Chat%20Record%20Management.md)
[Integration with Popular AI Tools](https://github.com/eliranwong/toolmate/wiki#integration)
# Quick Tool Calling
Starting with version 0.2.86+, users can utilize the `@` symbol to designate a specific tool within the application. The `toolmate` package now comes with a suite of pre-built tools:
@add_google_calendar_event @add_outlook_calendar_event @examine_audio_google @examine_audio_groq @examine_audio_openai @examine_audio_whisper @examine_files @examine_images_chatgpt @examine_images_gemini @examine_images_groq @examine_images_llamacpp @examine_images_ollama @examine_web_content @append_command @append_fabric @append_instruction @apps @ask_chatgpt @ask_codey @ask_gemini @ask_groq @ask_llama3_1 @ask_llamacpp @ask_llamacppserver @ask_o1 @ask_o1_mini @ask_ollama @ask_palm2 @ask_perplexica @ask_tavily @build_agents @chat @command @convert_relative_datetime @copy_to_clipboard @correct_python_code @create_image_dalle3 @create_image_flux @create_image_imagen3 @create_image_sd @create_map @create_qrcode @create_statistical_graphics @datetimes @deep_reflection @download_web_content @download_youtube_audio @download_youtube_video @edit_text @execute_computing_task @extract_python_code @fabric @files @general @help @images @improve_writing @install_python_package @it @list_current_directory_contents @load_conversations @lyrics @map @modify_images @music @news @open_browser @packages @paste_from_clipboard @qna @radio @read_aloud @recommend_tool @reflection @remove_image_background @repos @execute_python_code @save_memory @science @scientific_publications @search_conversations @search_finance @search_google @search_google_news @search_memory @search_searxng @search_sqlite @search_tavily @search_weather_info @send_gmail @send_outlook @send_tweet @social_media @software_wikis @translate @transcribe_audio_google @transcribe_audio_groq @transcribe_audio_openai @transcribe_audio_whisper @videos @web @wikimedia @workflow
Android-only tools:
@show_location @show_connection @start_recording @stop_recording @phone_call @play_media @search_contacts @take_photo @selfie @read_sms @send_sms @send_email @send_whatsapp @share @share_file
Additional bible tools, if you install optional `bible` module, by running `pip install --upgrade toolmate[bible]`:
@bible @bible_commentary @extract_bible_references @search_bible_ @search_bible_paragraphs @uba @uniquebible @uba_api @uniquebible_api
For those interested in expanding the capabilities of ToolMate AI, [custom tools can be added to the system via plugins](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Plugins%20-%20How%20to%20Write%20a%20Custom%20Plugin.md).
Tips:
* Type the `@` symbol to launch a drop-down menu listing all available tools for selection..
* Enter the `@` symbol to display a list of all available tools and their descriptions
* `@chat` is regarded as a single tool. If you just want a direct response generated by LLM, simply use `@chat`.
* `@command` `@execute_computing_task` is like a magic tools designed to execute computing tasks upon user requests.
* `@recommend_tool` is designed to help users to find an appropriate tool to resolve a given request.
* `@help` is created for searching documentations
# Selectie Screenshots
## NEW! Supports Android
## Brand New Tool Selection Agent
[Read more ...](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Selection%20Configurations.md)
## Multiple Tools in One Go
From version 0.2.87+, ToolMate AI supports use of multiple tools in a single request. It enables individual tools to work on results, generated by running previous tools.
Read more at: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Running%20Multiple%20Tools%20in%20One%20Go.md
## Customizable Plugins
## System Command and Fabric Integration
System Command Integration: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/System%20Command%20Integration.md
Fabric Integration: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Fabric%20Integration.md
## Support GPU Offloading
## Access to Real-time Data
## Access to Device Information
## Task Execution
## Content Creation
# Installation
For Windows / macOS / LinuX / ChromeOS users:
> pip install --upgrade toolmate
or
> pip install --upgrade toolmate_lite
The lite version `toolmate_lite` runs faster and supports Android Termux. It lacks some of the features that are equipped with the full version `toolmate`.
For Android users:
> pip install --upgrade toolmate_lite
## Extra Modules
`cpp` install additional cpp libraries, i.e. `llama-cpp-python[server]` and `stable-diffusion-cpp-python`
> pip install --upgrade toolmate[cpp]
`gui` install additional GUI library for running gui system tray and experimental desktop assistant
> pip install --upgrade toolmate[gui]
`linux` install additional packages for Linux users, i.e. `flaml[automl]`, `piper-tts`, `pyautogen[autobuild]`
> pip install --upgrade toolmate[linux]
`bible` install additional libraries for working with bible tools
> pip install --upgrade toolmate[bible]
Read more at https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Install%20ToolMate.md
# GPU Acceleration
[GPU Acceleration](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/GPU%20Acceleration.md)
[GPU Acceleration with Llama.cpp Server](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/GPU%20Acceleration%20with%20Llama_cpp%20server.md)
# Quick Guide
https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Quick%20Guide.md
# More
Documentation https://github.com/eliranwong/toolmate/wiki
# Welcome Contributions
You are welcome to make contributions to this project by:
* joining the development collaboratively
* donations to show support and invest for the future
Support link: https://www.paypal.me/letmedoitai
Please kindly report of any issues at https://github.com/eliranwong/toolmate/issues
Raw data
{
"_id": null,
"home_page": "https://letmedoit.ai",
"name": "toolmate",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "ai assistant ollama llama llamacpp groq openai chatgpt gemini autogen rag agent stable-diffusion fabric dalle imagen",
"author": "Eliran Wong",
"author_email": "support@letmedoit.ai",
"download_url": "https://files.pythonhosted.org/packages/4a/23/22df3885f9d8cc6c7b98d8546211207cd2cb2b43ac24c265e0c1cf4c6614/toolmate-0.5.81.tar.gz",
"platform": null,
"description": "# ToolMate AI\n\nToolMate AI, formerly known as FreeGenius AI, is a cutting-edge AI companion that seamlessly integrates agents, tools, and plugins to excel in conversations, generative work, and task execution. With the ability to perform multi-step actions, users can customize workflows to tackle complex projects with ease.\n\n\n\n# Background\n\nhttps://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/LetMeDoIt%20Mode.md\n\n# Documentation\n\nhttps://github.com/eliranwong/toolmate/wiki\n\n# Latest changes\n\nhttps://github.com/eliranwong/toolmate/blob/main/latest_changes.md\n\n# Supported Platforms\n\nWindows, macOS, Linux, ChromeOS, Android\n\n# AI Backends and Models\n\nToolMate AI supports a wide range of AI backends and models, including [Ollama, Llama.cpp, Llama-cpp-python, Groq Cloud API, Mistral AI API, X AI API, OpenAI API, Google AI Studio API and Google Vertex AI](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Supported%20Backends%20and%20Models.md). Llama-cpp-python is selected as the default backend because it is completely free and requires no additional setup. However, users can switch backends at any time.\n\nOur recommendations:\n* For backend selection, we consider [Ollama](https://ollama.com/) as the best friendly free `offline` option and [Groq Cloud API](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Groq%20API%20Setup.md) as the best freiendly and free `online` option.\n\n* Remarks: Though Llama.cpp requires extra setup, it runs faster inference with the same model, compared to Ollama, when they are running on Android Termux.\n\nRead more at https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Supported%20Backends%20and%20Models.md\n\n# New Additions\n\n[NEW! Support Ollama v0.5.0+ latest structured output feature](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Configure%20Ollama%20Server.md)\n\n[NEW! Support Llama.cpp server running on Android](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Android%20Versions.md)\n\n[NEW! Support X AI / Grok API Keys](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/xAI.md)\n\n[NEW! ToolMate API Server & Client](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/ToolMate%20API%20Server.md)\n\n[NEW! Support Mistral API Keys](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Mistral%20API%20Setup.md)\n\n[NEW! Edit Current Conversation](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Edit%20Current%20Conversation.md)\n\n[NEW! Support Android](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Android%20Versions.md)\n\n[NEW! Perplexica and SearXNG Integration](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Perplexica%20and%20SearXNG%20Integration.md#searxng-setup)\n\n# Distinctive Features\n\n[Tool Selection Agent](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Selection%20Configurations.md)\n\n[Deep Reflection Agents](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Reflection%20Agents.md)\n\n[Risk Management Agent](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Risk%20Management%20Agent.md)\n\n[Running Multiple Tools in One Go](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Running%20Multiple%20Tools%20in%20One%20Go.md)\n\n[Plentiful Built-in Tools](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Descriptions.md)\n\n[Highly Customisable Plugins](https://github.com/eliranwong/toolmate/wiki#plugins)\n\n[Savable, Searchable and Sharable Records](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Chat%20Record%20Management.md)\n\n[Integration with Popular AI Tools](https://github.com/eliranwong/toolmate/wiki#integration)\n\n# Quick Tool Calling\n\nStarting with version 0.2.86+, users can utilize the `@` symbol to designate a specific tool within the application. The `toolmate` package now comes with a suite of pre-built tools:\n\n@add_google_calendar_event @add_outlook_calendar_event @examine_audio_google @examine_audio_groq @examine_audio_openai @examine_audio_whisper @examine_files @examine_images_chatgpt @examine_images_gemini @examine_images_groq @examine_images_llamacpp @examine_images_ollama @examine_web_content @append_command @append_fabric @append_instruction @apps @ask_chatgpt @ask_codey @ask_gemini @ask_groq @ask_llama3_1 @ask_llamacpp @ask_llamacppserver @ask_o1 @ask_o1_mini @ask_ollama @ask_palm2 @ask_perplexica @ask_tavily @build_agents @chat @command @convert_relative_datetime @copy_to_clipboard @correct_python_code @create_image_dalle3 @create_image_flux @create_image_imagen3 @create_image_sd @create_map @create_qrcode @create_statistical_graphics @datetimes @deep_reflection @download_web_content @download_youtube_audio @download_youtube_video @edit_text @execute_computing_task @extract_python_code @fabric @files @general @help @images @improve_writing @install_python_package @it @list_current_directory_contents @load_conversations @lyrics @map @modify_images @music @news @open_browser @packages @paste_from_clipboard @qna @radio @read_aloud @recommend_tool @reflection @remove_image_background @repos @execute_python_code @save_memory @science @scientific_publications @search_conversations @search_finance @search_google @search_google_news @search_memory @search_searxng @search_sqlite @search_tavily @search_weather_info @send_gmail @send_outlook @send_tweet @social_media @software_wikis @translate @transcribe_audio_google @transcribe_audio_groq @transcribe_audio_openai @transcribe_audio_whisper @videos @web @wikimedia @workflow\n\nAndroid-only tools:\n\n@show_location @show_connection @start_recording @stop_recording @phone_call @play_media @search_contacts @take_photo @selfie @read_sms @send_sms @send_email @send_whatsapp @share @share_file\n\nAdditional bible tools, if you install optional `bible` module, by running `pip install --upgrade toolmate[bible]`:\n\n@bible @bible_commentary @extract_bible_references @search_bible_ @search_bible_paragraphs @uba @uniquebible @uba_api @uniquebible_api\n\nFor those interested in expanding the capabilities of ToolMate AI, [custom tools can be added to the system via plugins](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Plugins%20-%20How%20to%20Write%20a%20Custom%20Plugin.md).\n\nTips: \n\n* Type the `@` symbol to launch a drop-down menu listing all available tools for selection..\n* Enter the `@` symbol to display a list of all available tools and their descriptions\n* `@chat` is regarded as a single tool. If you just want a direct response generated by LLM, simply use `@chat`.\n* `@command` `@execute_computing_task` is like a magic tools designed to execute computing tasks upon user requests.\n* `@recommend_tool` is designed to help users to find an appropriate tool to resolve a given request.\n* `@help` is created for searching documentations\n\n# Selectie Screenshots\n\n## NEW! Supports Android\n\n\n\n## Brand New Tool Selection Agent\n\n\n\n[Read more ...](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Tool%20Selection%20Configurations.md)\n\n## Multiple Tools in One Go\n\nFrom version 0.2.87+, ToolMate AI supports use of multiple tools in a single request. It enables individual tools to work on results, generated by running previous tools.\n\n\n\nRead more at: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Running%20Multiple%20Tools%20in%20One%20Go.md\n\n## Customizable Plugins\n\n\n\n## System Command and Fabric Integration\n\nSystem Command Integration: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/System%20Command%20Integration.md\n\nFabric Integration: https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Fabric%20Integration.md\n\n## Support GPU Offloading\n\n\n\n## Access to Real-time Data\n\n\n\n## Access to Device Information\n\n\n\n## Task Execution\n\n\n\n## Content Creation\n\n\n\n# Installation\n\nFor Windows / macOS / LinuX / ChromeOS users:\n\n> pip install --upgrade toolmate\n\nor \n\n> pip install --upgrade toolmate_lite\n\nThe lite version `toolmate_lite` runs faster and supports Android Termux. It lacks some of the features that are equipped with the full version `toolmate`.\n\nFor Android users:\n\n> pip install --upgrade toolmate_lite\n\n## Extra Modules\n\n`cpp` install additional cpp libraries, i.e. `llama-cpp-python[server]` and `stable-diffusion-cpp-python`\n\n> pip install --upgrade toolmate[cpp]\n\n`gui` install additional GUI library for running gui system tray and experimental desktop assistant\n\n> pip install --upgrade toolmate[gui]\n\n`linux` install additional packages for Linux users, i.e. `flaml[automl]`, `piper-tts`, `pyautogen[autobuild]`\n\n> pip install --upgrade toolmate[linux]\n\n`bible` install additional libraries for working with bible tools\n\n> pip install --upgrade toolmate[bible]\n\nRead more at https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Install%20ToolMate.md\n\n# GPU Acceleration\n\n[GPU Acceleration](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/GPU%20Acceleration.md)\n\n[GPU Acceleration with Llama.cpp Server](https://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/GPU%20Acceleration%20with%20Llama_cpp%20server.md)\n\n# Quick Guide\n\nhttps://github.com/eliranwong/toolmate/blob/main/package/toolmate/docs/Quick%20Guide.md\n\n# More\n\nDocumentation https://github.com/eliranwong/toolmate/wiki\n\n# Welcome Contributions\n\nYou are welcome to make contributions to this project by:\n\n* joining the development collaboratively\n\n* donations to show support and invest for the future\n\nSupport link: https://www.paypal.me/letmedoitai\n\nPlease kindly report of any issues at https://github.com/eliranwong/toolmate/issues\n",
"bugtrack_url": null,
"license": "GNU General Public License (GPL)",
"summary": "ToolMate AI, developed by Eliran Wong, is a cutting-edge AI companion that seamlessly integrates agents, tools, and plugins to excel in conversations, generative work, and task execution. Supports custom workflow and plugins to automate multi-step actions.",
"version": "0.5.81",
"project_urls": {
"Documentation": "https://github.com/eliranwong/toolmate/wiki",
"Funding": "https://www.paypal.me/letmedoitai",
"Homepage": "https://letmedoit.ai",
"Source": "https://github.com/eliranwong/toolmate",
"Tracker": "https://github.com/eliranwong/toolmate/issues"
},
"split_keywords": [
"ai",
"assistant",
"ollama",
"llama",
"llamacpp",
"groq",
"openai",
"chatgpt",
"gemini",
"autogen",
"rag",
"agent",
"stable-diffusion",
"fabric",
"dalle",
"imagen"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "36848140d5469b12d5403ce4b1b57b9fe3971394b5a324935f1e98ef75da1fa1",
"md5": "98824ee15faa2d99e73dc6030c5c2458",
"sha256": "6e4bd6f907151f5964efac97a1e4a349194e33069bdca66070738fcae748b82f"
},
"downloads": -1,
"filename": "toolmate-0.5.81-py3-none-any.whl",
"has_sig": false,
"md5_digest": "98824ee15faa2d99e73dc6030c5c2458",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 9689277,
"upload_time": "2024-12-17T23:28:08",
"upload_time_iso_8601": "2024-12-17T23:28:08.955276Z",
"url": "https://files.pythonhosted.org/packages/36/84/8140d5469b12d5403ce4b1b57b9fe3971394b5a324935f1e98ef75da1fa1/toolmate-0.5.81-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4a2322df3885f9d8cc6c7b98d8546211207cd2cb2b43ac24c265e0c1cf4c6614",
"md5": "031deb7bafa8e3ac819351c8d239728e",
"sha256": "f77aa3c8369598fcfeacece08ab25dab3409381e303c403a53322603c413550b"
},
"downloads": -1,
"filename": "toolmate-0.5.81.tar.gz",
"has_sig": false,
"md5_digest": "031deb7bafa8e3ac819351c8d239728e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 9418941,
"upload_time": "2024-12-17T23:28:15",
"upload_time_iso_8601": "2024-12-17T23:28:15.762122Z",
"url": "https://files.pythonhosted.org/packages/4a/23/22df3885f9d8cc6c7b98d8546211207cd2cb2b43ac24c265e0c1cf4c6614/toolmate-0.5.81.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-17 23:28:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "eliranwong",
"github_project": "toolmate",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "toolmate"
}
JSON
