Skip to main content

FreeGenius AI, an advanced AI assistant that is capable of engaging in conversation and performing multi-step actions. Supports numerous open-source LLMs via Llama.cpp or Ollama or Groq Cloud API, with optional integration with AutoGen agents, OpenAI API, Google Gemini Pro, fabric and unlimited plugins.

Project description

# FreeGenius AI

FreeGenius AI is an ambitious project sparked by the pioneering work of [LetMeDoIt AI](https://github.com/eliranwong/letmedoit). It’s designed with the primary objective of offering a comprehensive suite of AI solutions that mirror the capabilities of [LetMeDoIt AI](https://github.com/eliranwong/letmedoit). However, FreeGenius AI is remarkably different in that all core features are completely free, and it doesn’t require the use of an OpenAI key.

As with [LetMeDoIt AI](https://github.com/eliranwong/letmedoit), FreeGenius AI is designed to be capable of engaging in intuitive conversations, executing codes, providing up-to-date information, and performing a wide range of tasks. It’s designed to learn, adapt, and grow with the user, offering personalized experiences and interactions.

Our recent developments, for example, [the ability to run multiple tools in a single request](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Running%20Multiple%20Tools%20in%20One%20Go.md), demonstrate that FreeGenius AI is far more capable than LetMeDoIt AI, while we still maintain backward compatibility with [LetMeDoIt AI](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/LetMeDoIt%20Mode.md).

FreeGenius AI supports [a wide range of AI backends and models](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Supported%20Backends%20and%20Models.md): Ollama, Llama.cpp, Llama-cpp-python (default), Groq Cloud API, OpenAI API, Google Gemini via Vertex AI. Llama-cpp-python is selected as backend by default, only because it does not require an extra step for setup.

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/freegenius/blob/main/package/freegenius/docs/Groq%20API%20Setup.md) as the best freiendly and free online option. * With regard to AI models, we have found wizardlm2 and mixtral works well FreeGenius AI, though many other are well-supported.

# Latest changes

https://github.com/eliranwong/freegenius/blob/main/latest_changes.md

## Beyond LetMeDoIt AI

https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/LetMeDoIt%20Mode.md

# Distinctive Features

[Support Wide Range of Backends and Models](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Supported%20Backends%20and%20Models.md)

[Tool Calling for Any LLMs](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Function%20Call%20Approach%20with%20Any%20LLMs.md)

[Running Multiple Tools in One Go](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Running%20Multiple%20Tools%20in%20One%20Go.md)

[Highly Customisable Plugins](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/000_Home.md#plugins)

[Integration with Popular AI Tools](https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/000_Home.md#integration)

# Quick Tool Calling

Version 0.2.86+ supports use of @ to specify a tool. Available tools:

@chat @paste_from_clipboard @improve_writing @convert_relative_datetime @copy_to_clipboard @append_prompt @command @append_command @fabric @append_fabric @list_current_directory_contents @extract_python_code @run_python_code @integrate_google_searches @add_google_calendar_event @add_outlook_calendar_event @analyze_audio @analyze_files @analyze_images @analyze_web_content @ask_chatgpt @ask_codey @ask_gemini @ask_groq @ask_llama3_1 @ask_llamacpp @ask_llamacppserver @ask_ollama @ask_palm2 @correct_python @build_agents @create_image @create_map @create_qrcode @create_statistical_graphics @datetimes @download_web_content @download_youtube_audio @download_youtube_video @edit_text @execute_computing_task @install_package @save_memory @retrieve_memory @modify_images @open_browser @pronunce_words @remove_image_background @search_chats @load_chats @search_finance @search_latest_news @search_sqlite @search_weather_info @send_gamil @send_outlook @send_tweet

![tools](https://github.com/user-attachments/assets/d3a301ee-a228-4d0c-882e-0dd06141be2f)

Remarks:

  • @chat is regarded as a single tool. If you just want a direct response generated by LLM, simply use @chat.

  • @execute_computing_task is like a magic tool designed to execute computing tasks on demand.

Tips: Enter @ to get input suggestions of available tools

# Selective Features

# Multiple Tools in One Go

From version 0.2.87+, FreeGenius AI supports use of multiple tools in a single request. It enables individual tools to work on results, generated by running previous tools.

![multiple_tools_in_single_prompt](https://github.com/user-attachments/assets/7bdc63cd-beca-44c9-bfb0-27596a5e0632)

Read more at: https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Running%20Multiple%20Tools%20in%20One%20Go.md

# Customizable Plugins

![plugins](https://github.com/eliranwong/freegenius/assets/25262722/6bb4b2f6-5684-42c1-95e3-7b12c3a38db6)

# System Command and Fabric Integration

System Command Integration: https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/System%20Command%20Integration.md

Fabric Integration: https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Fabric%20Integration.md

# Support GPU Offloading

![llamacpp_with_gpu_offloading_compressed](https://github.com/eliranwong/freegenius/assets/25262722/2d607fc1-e6b5-4c62-be14-325d73866fce)

# Access to Real-time Data

![realtime_information](https://github.com/eliranwong/freegenius/assets/25262722/d94fd9c3-f242-4c8c-8564-308f866e9adb)

# Access to Device Information

![access_device_information](https://github.com/eliranwong/freegenius/assets/25262722/6e3386a4-7314-4ce5-a64f-fffe35dff92e)

# Task Execution

![freegenius_ai_screenshot](https://github.com/eliranwong/freegenius/assets/25262722/1e9dd18e-aa4b-4e2c-8d76-386af7ba00ea)

# Content Creation

![content_creation](https://github.com/eliranwong/freegenius/assets/25262722/5582d519-b925-4e1b-8fd8-ecaa8422d391)

# Supported Platforms

Windows, macOS, Linux, ChromeOS

Upcoming: Android

# Installation - an example

Install FreeGenius AI, by running:

To set up virtual environment (recommended):

> mkdir -p ~/apps/freegenius

> cd ~/apps/freegenius

> python3 -m venv freegenius

> source freegenius/bin/activate

To install:

> pip install –upgrade freegenius

Remarks: Auto-upgrade is supported in macOS and Linux versions, but not in Windows version. Windows users need to manually upgrade to get the latest features.

To run:

> freegenius

To start up with a particular backend, you may use parameter -b, e.g.:

> freegenius -b groq

Read more at https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/000_Home.md#installation

# Quick Guide

https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/Quick%20Guide.md

# More

Documentation https://github.com/eliranwong/freegenius/blob/main/package/freegenius/docs/000_Home.md

# 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/freegenius/issues

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

freegenius-0.3.15.tar.gz (5.5 MB view details)

Uploaded Source

Built Distribution

freegenius-0.3.15-py3-none-any.whl (5.7 MB view details)

Uploaded Python 3

File details

Details for the file freegenius-0.3.15.tar.gz.

File metadata

  • Download URL: freegenius-0.3.15.tar.gz
  • Upload date:
  • Size: 5.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for freegenius-0.3.15.tar.gz
Algorithm Hash digest
SHA256 217dde691350e5c7985f03d618b6591c2587ca4ec2b52f42bf0dc18c6f1cd27c
MD5 0245ee7a54c5bd87d5205bed995a2a0e
BLAKE2b-256 cf19e74d044a48ebb1ce420170c6d9c1d9bfbef479a71eb164936e71d548e7ab

See more details on using hashes here.

File details

Details for the file freegenius-0.3.15-py3-none-any.whl.

File metadata

  • Download URL: freegenius-0.3.15-py3-none-any.whl
  • Upload date:
  • Size: 5.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for freegenius-0.3.15-py3-none-any.whl
Algorithm Hash digest
SHA256 d8ee85a3500128e1806712ec570ee5e0ce5df38cc98425b9a9853103828ec17f
MD5 05d054332a93130217dda90a56bcdc4c
BLAKE2b-256 da4024fc55130a8b47449f50032b65fa5c9e737a1c6e067416534b3c20c39b3b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page