{"id":15165929,"url":"https://github.com/firatkiral/kodibot","last_synced_at":"2025-10-23T02:43:53.168Z","repository":{"id":232106651,"uuid":"778206675","full_name":"firatkiral/kodibot","owner":"firatkiral","description":"Local and Offline AI Chatbot App for Desktop","archived":false,"fork":false,"pushed_at":"2024-04-10T20:58:12.000Z","size":5282,"stargazers_count":18,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-19T04:36:49.007Z","etag":null,"topics":["ai","ai-assistant","chatbot","llamacpp","llm","openai"],"latest_commit_sha":null,"homepage":"https://kodibot.com/","language":"CSS","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/firatkiral.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":"2024-03-27T09:33:38.000Z","updated_at":"2024-12-15T17:11:58.000Z","dependencies_parsed_at":"2024-04-10T21:29:01.124Z","dependency_job_id":null,"html_url":"https://github.com/firatkiral/kodibot","commit_stats":null,"previous_names":["firatkiral/kodibot"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firatkiral%2Fkodibot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firatkiral%2Fkodibot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firatkiral%2Fkodibot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firatkiral%2Fkodibot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firatkiral","download_url":"https://codeload.github.com/firatkiral/kodibot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230852605,"owners_count":18290081,"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":["ai","ai-assistant","chatbot","llamacpp","llm","openai"],"created_at":"2024-09-27T04:20:25.594Z","updated_at":"2025-10-23T02:43:53.091Z","avatar_url":"https://github.com/firatkiral.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![KodiBot](https://kodibot.com/assets/images/screenshot-7789f673756b43b7bfb8af5c207600ec.png)\n\n### KodiBot - Local Chatbot App for Desktop\n\nKodiBot is a desktop app that enables users to run their own AI chat assistants locally and offline on Windows, Mac, and Linux operating systems. KodiBot is a standalone app and does not require an internet connection or additional dependencies to run local chat assistants. It supports both [Llama.cpp](https://github.com/ggerganov/llama.cpp) compatible models and [OpenAI](https://openai.com/) API. \n\nKodiBot is free and open source app developed using electronjs framework and released under the GNU General Public License.\n\nPlease visit [kodibot.com](https://kodibot.com) for more information.\n\n### Requirements\n\n- Average gaming PC or laptop with Windows, Mac, or Linux operating system\n\n### Features\n\nKodiBot has a simple and user friendly interface. You can esily create chat assistant cards and customize them for specific tasks or topics by adding instructions. You can save cards to JSON file share them with others. KodiBot supports both Llama.cpp compatible models and OpenAI API. It stores your history with each chat assistant separately. You can easily navigate and switch between chat assistants from the sidebar.\n\n### Creating Local Assistant\n\nYou can either duplicate an existing KodiBot assistant card or create a new one. If you duplicate KodiBot Assistant, you can simply customize the instructions for your specific task or topic. \n\nIf you create a new local assistant, you can choose the default model file or you can download any llama.cpp compatible model from [huggingface.co](https://huggingface.co). You'll also need to add prompt and history template to be able to feed proper prompt to the model you choose. You can find these information in the model's documentation. You can leave other advanced settings as default.\n\n### Using OpenAI API\n\nWith OpenAi API you can use latest Chat GPT models without paying monthly subscription fees, you only pay for what you use with a pay-as-you-go pricing. You can use OpenAI API by creating an API key from [OpenAI](https://openai.com/). Then you can add your API key to assistant settings. If your api key is valid it will automatically load available chat models such as GPT-3, GPT-4, etc. You can choose a model of your choice and start chatting with your assistant. You can also customize instructions for your specific task. \n\n### Usage\n\nFirst install the dependencies:\n\n```bash\nnpm install\n```\n\nThen run the app:\n\n```bash\nnpm start\n```\n\n### Custom API Calls\n\nWhen you select an assistant card, it will automatically start an API server on the API URL and port specified in the assistant settings. You can use this URL to make custom API calls to the assistant. Please see the [Llama.cpp API](https://github.com/ggerganov/llama.cpp/tree/master/examples/server) documentation for more information.\n\n## License\n\nKodiBot Copyright © 2024\n\nKodiBot is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nKodiBot is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with KodiBot. If not, see \u003chttps://www.gnu.org/licenses/\u003e.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiratkiral%2Fkodibot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiratkiral%2Fkodibot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiratkiral%2Fkodibot/lists"}