{"id":13644497,"url":"https://github.com/ohmplatform/freedomgpt","last_synced_at":"2025-05-15T06:05:06.636Z","repository":{"id":148710690,"uuid":"617048769","full_name":"ohmplatform/FreedomGPT","owner":"ohmplatform","description":"This codebase is for a React and Electron-based app that executes the FreedomGPT LLM locally (offline and private) on Mac and Windows using a chat-based interface","archived":false,"fork":false,"pushed_at":"2024-06-13T18:52:39.000Z","size":43042,"stargazers_count":2645,"open_issues_count":77,"forks_count":355,"subscribers_count":57,"default_branch":"main","last_synced_at":"2025-05-15T06:04:24.250Z","etag":null,"topics":["electron","gpt","llm","react"],"latest_commit_sha":null,"homepage":"http://www.freedomgpt.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ohmplatform.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-21T15:46:11.000Z","updated_at":"2025-05-14T20:10:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"f915afed-1754-414b-9b4d-a2ea0e9bfe62","html_url":"https://github.com/ohmplatform/FreedomGPT","commit_stats":null,"previous_names":["ohmplatform/freedom-gpt-electron-app"],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmplatform%2FFreedomGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmplatform%2FFreedomGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmplatform%2FFreedomGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ohmplatform%2FFreedomGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ohmplatform","download_url":"https://codeload.github.com/ohmplatform/FreedomGPT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254283339,"owners_count":22045140,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","gpt","llm","react"],"created_at":"2024-08-02T01:02:06.033Z","updated_at":"2025-05-15T06:05:06.609Z","avatar_url":"https://github.com/ohmplatform.png","language":"TypeScript","readme":"# FreedomGPT\nThis is the offical repository for the FreedomGPT application. It is built using [Electron](https://www.electronjs.org/) and [React](https://reactjs.org/) and allows users to run LLM models on their local machine.\n\n![GitHub license](https://img.shields.io/badge/license-GNU-blue.svg)\n\n![GitHub release](https://img.shields.io/github/release/ohmplatform/freedom-gpt-electron-app.svg)\n\n![GitHub stars](https://img.shields.io/github/stars/ohmplatform/freedom-gpt-electron-app.svg)\n\n![GitHub All Releases](https://img.shields.io/github/downloads/ohmplatform/freedom-gpt-electron-app/total.svg)\n\n# Join our Discord Community\nJoin our Discord server to get the latest updates and to interact with the community.\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/h77wvJS4ga)\n\n\n# How to Contribute\n\n## Prerequisites\n- [Node.js](https://nodejs.org/en/download/)\n- [Git](https://git-scm.com/downloads)\n\n## Quick Install\n```sh\ngit clone --recursive https://github.com/ohmplatform/FreedomGPT.git freedom-gpt\ncd freedom-gpt\nnpx yarn install\n```\n\n### Building the llama.cpp library\n\n#### macOS\n```sh\ncd llama.cpp\nmake\n```\n\n#### Windows\n- Download and install CMake: \u003chttps://cmake.org/download/\u003e\n- Run the following commands:\n\n```ps1\ncd llama.cpp\ncmake .\ncmake --build . --config Release\n```\n\nYou should now have a `Release` folder with a `main.exe` file inside it. You can run this file to test the chat client.\n\n\n### Running the App\nTo run the app, run the following command in your terminal from the root directory of the project:\n\n```sh\nnpx yarn start\n```\n\n## Changing Ports\nIf needed, ports can be changed in:\n`src/ports.ts`\n\n## Installation and Setup Guide for Linux\n\n### Required Packages\n\nTo get started, you need to install several required packages. Run the following commands:\n\n```bash\nsudo apt install nodejs\nsudo apt install yarn\nsudo apt install git\nsudo apt install make\nsudo apt install g++\nsudo apt install npm\n```\n\n### Build the Project\n\nNavigate to the project directory and build it:\n\n```bash\ncd freedom-gpt/llama.cpp\nmake\ncd ..\nnpm install\nnpm run\nnpm start\n```\n\n### Usage\n\n### Working with Liberty Edge Models\n\nYou can manually download the Liberty Edge models and set the paths to these files from the AI Models screen.\n\n### Mining Earnings\n\nTo enable mining earnings, follow these steps:\n\n1. Download the XMRig Linux Static, CPU-only version from [xmrig.com/download](https://xmrig.com/download)\n2. Extract the archive and copy the `xmrig` binary to the `freedom-gpt/miner/mac/fgptminer` directory:\n\n```bash\n# Assuming you have extracted xmrig in the current directory\ncp xmrig freedom-gpt/miner/mac/fgptminer\n```\n\n\n\u003c!-- ## Dockerizing the App\n\nTo run the docker image, run the following command in your terminal:\n\n```sh\ndocker pull freedomgpt/freedomgpt\ndocker run -d -p 8889:8889 freedomgpt/freedomgpt\n```\n\nIf you want to build the docker image yourself, run the following command in your terminal:\n\n```sh\ndocker build -t freedomgpt/freedomgpt .\n\nOR\n\nnpx yarn docker\n``` --\u003e\n\n# Credits\n\nThis project utilizes several open-source packages and libraries, without which this project would not have been possible:\n\n\"llama.cpp\" - C++ library. https://github.com/ggerganov/llama.cpp\n\n\"LLAMA\" by Facebook Research - a low-latency, large-scale approximate nearest neighbor search algorithm. https://github.com/facebookresearch/llama\n\n\"Chatbot UI\" - https://github.com/mckaywrigley/chatbot-ui\n\nWe would like to express our gratitude to the developers of these packages and their contributors for making their work available to the public under open source licenses. Their contributions have enabled us to build a more robust and efficient project.\n\n# LICENSE\n\nSee the \u003ca href=\"/LICENSE\"\u003e LICENSE \u003c/a\u003efile.\n","funding_links":[],"categories":["NLP"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fohmplatform%2Ffreedomgpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fohmplatform%2Ffreedomgpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fohmplatform%2Ffreedomgpt/lists"}